Rom*_*man 4 java oop api-design naming-conventions
介绍:
我正在开发一个API,可以访问Picasa,Flickr和其他一些图像服务.
我有一个WebAlbum类(它提供对嵌套照片,专辑的访问,如果允许,以及一些元信息).
我的API不仅允许用户阅读专辑,还允许用户创建新专辑.在一般情况下,为了创建新专辑,API用户应该使用工厂方法,该方法创建专辑然后调用该方法WebGallery#addAlbum (newAlbum).
但是Flickr不允许创建空白专辑,它需要在任何新专辑中至少有一张预定义的照片(可能会制作漂亮的专辑预览).在Flickr术语中,第一张照片称为Primary Photo.因此,为了为Flickr创建相册,用户应使用工厂方法,然后将图像添加到新相册,然后调用WebGallery#addAlbum (newAlbum).
问题:
目前WebAlbum类有这种方法
public interface WebAlbum {
...
public boolean requiresPrimaryPhoto ();
}
Run Code Online (Sandbox Code Playgroud)
我不能保留此名称,因为PrimaryPhoto只是一个Flickr术语.我可以改成它
public interface WebAlbum {
...
//with spaces: requires one added photo to create new album
public boolean requiresOneAddedPhotoToCreateNewAlbum ();
}
Run Code Online (Sandbox Code Playgroud)
请建议一个具有相同含义的较短名称.