如果我只有很少的返回非公共(public)类型的工厂方法和一对给出这种非公共(public)类型变量的方法怎么办?这会在 NetBeans 中产生带标题的警告消息。
结果,公共(public) API 将仅包含两组配对方法。原因是使我的类型层次结构密封(就像 Scala 中的密封类)并允许用户仅通过工厂方法实例化这些类型。所以我们在某种意义上得到了 DSL。
例如,日程表类由日历字段的约束表示。有一些类型的约束——Range、Singleton、List、FullSet——以 NumberSet 接口(interface)为根。我们不想公开这些类型以及 Schedule 如何与它们交互。我们只需要用户的规范。所以我们让 NumberSet 包私有(private)。在 Schedule 类中,我们为约束创建了几个工厂方法:
NumberSet singleton(int value);
NumberSet range(int form, int to);
NumberSet list(NumberSet ... components);
以及一些创建Schedule对象的方法:
Schedule everyHour(NumberSet minutes);
Schedule everyDay(NumberSet minutes, NumberSet hours);
用户只能按照以下方式使用它们:
Schedule s = Schedule.everyDay( singleton(0), list(range(10-15), singleton(8)) );
这是个坏主意吗?
最佳答案
这个想法本身是合理的。但如果您将根类型(此处:NumberSet)包设为私有(private),它就不会起作用。公开该类型或改用公共(public)接口(interface)。应该(并且可以)隐藏实际的实现类型。
public abstract class NumberSet {
// Constructor is package private, so no new classes can be derived from
// this guy outside of its package.
NumberSet() {
}
}
public class Factories {
public NumberSet range(int start, int length) {
return new RangeNumberSet(start, length);
}
// ...
}
class RangeNumberSet extends NumberSet {
// ... must be defined in the same package as NumberSet
// Is "invisible" to client code
}
编辑 从公共(public) API 公开隐藏/私有(private)根类型是错误的。考虑以下场景:
package example;
class Bar {
public void doSomething() {
// ...
}
}
public class Foo {
public Bar newBar() {
return new Bar();
}
}
并考虑使用此 API 的客户端应用程序。客户能做什么?它不能正确地将变量声明为 Bar 类型,因为该类型对于 example 包之外的任何类都是不可见的。它甚至不能在从某处获得的 Bar 实例上调用 public 方法,因为它不知道这样一个公共(public)方法的存在(它看不到类,更不用说它公开的任何成员)。因此,客户在这里可以做的最好的事情是:
Object bar = foo.newBar();
这基本上是无用的。另一件事是拥有一个公共(public)接口(interface)(或抽象类)而不是包私有(private)接口(interface),如上面定义的代码。在这种情况下,客户端实际上可以声明NumberSet 类型的变量。它不能创建自己的实例或派生子类,因为构造函数对它是隐藏的,但它可以访问定义的公共(public) API。
再次编辑 即使您想要一个“无特征”的值(从客户端的角度来看),即一个没有定义客户端可能想要调用的任何有趣 API 的值,它仍然是以上述方式公开公共(public)基类型是个好主意。并且仅出于编译器能够执行类型检查并允许客户端代码将此类值临时存储到(正确声明的)变量中的目的。
如果您不希望您的客户端调用该类型的任何 API 方法:那很好。没有什么可以阻止您不为您的(否则)公共(public)基类型提供公共(public) API。只是不要声明任何东西。使用“空”抽象基类(从客户端的角度来看是空的,因为所有有趣的方法都将被包私有(private)并因此被隐藏)。但是您仍然必须提供一个公共(public)基类型,或者您应该使用普通的 Object 作为返回值,但这样您就无法在编译时进行错误检查。
经验法则:如果客户端必须调用一些方法来获取值并将其传递给其他 API,那么客户端实际上知道,有一些神奇的特殊值.而且它必须能够以某种方式处理它(至少“传递它”)。不为客户端提供正确的类型来处理这些值不会给你带来任何好处,除了(完全合适的)编译器警告。
public abstract class Specification {
Specification() {
// Package private, thus not accessible to the client
// No subclassing possible
}
Stuff getInternalValue1() {
// Package private, thus not accessible to the client
// Client cannot call this
}
}
就客户端代码而言,上述类是“空的”;除了 Object 已经提供的内容外,它不提供可用的 API。拥有它的主要好处是:客户端可以声明这种类型的变量,并且编译器能够进行类型检查。但是,您的框架仍然是唯一可以创建此类具体实例的地方,因此,您的框架可以完全控制所有值。
关于java - 通过公共(public) API 导出非公共(public)类型,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/2744851/
尝试通过RVM将RubyGems升级到版本1.8.10并出现此错误:$rvmrubygemslatestRemovingoldRubygemsfiles...Installingrubygems-1.8.10forruby-1.9.2-p180...ERROR:Errorrunning'GEM_PATH="/Users/foo/.rvm/gems/ruby-1.9.2-p180:/Users/foo/.rvm/gems/ruby-1.9.2-p180@global:/Users/foo/.rvm/gems/ruby-1.9.2-p180:/Users/foo/.rvm/gems/rub
我正在使用puppet为ruby程序提供一组常量。我需要提供一组主机名,我的程序将对其进行迭代。在我之前使用的bash脚本中,我只是将它作为一个puppet变量hosts=>"host1,host2"我将其提供给bash脚本作为HOSTS=显然这对ruby不太适用——我需要它的格式hosts=["host1","host2"]自从phosts和putsmy_array.inspect提供输出["host1","host2"]我希望使用其中之一。不幸的是,我终其一生都无法弄清楚如何让它发挥作用。我尝试了以下各项:我发现某处他们指出我需要在函数调用前放置“function_”……这
我正在编写一个gem,我必须在其中fork两个启动两个webrick服务器的进程。我想通过基类的类方法启动这个服务器,因为应该只有这两个服务器在运行,而不是多个。在运行时,我想调用这两个服务器上的一些方法来更改变量。我的问题是,我无法通过基类的类方法访问fork的实例变量。此外,我不能在我的基类中使用线程,因为在幕后我正在使用另一个不是线程安全的库。所以我必须将每个服务器派生到它自己的进程。我用类变量试过了,比如@@server。但是当我试图通过基类访问这个变量时,它是nil。我读到在Ruby中不可能在分支之间共享类变量,对吗?那么,还有其他解决办法吗?我考虑过使用单例,但我不确定这是
我的最终目标是安装当前版本的RubyonRails。我在OSXMountainLion上运行。到目前为止,这是我的过程:已安装的RVM$\curl-Lhttps://get.rvm.io|bash-sstable检查已知(我假设已批准)安装$rvmlistknown我看到当前的稳定版本可用[ruby-]2.0.0[-p247]输入命令安装$rvminstall2.0.0-p247注意:我也试过这些安装命令$rvminstallruby-2.0.0-p247$rvminstallruby=2.0.0-p247我很快就无处可去了。结果:$rvminstall2.0.0-p247Search
我可以得到Infinity和NaNn=9.0/0#=>Infinityn.class#=>Floatm=0/0.0#=>NaNm.class#=>Float但是当我想直接访问Infinity或NaN时:Infinity#=>uninitializedconstantInfinity(NameError)NaN#=>uninitializedconstantNaN(NameError)什么是Infinity和NaN?它们是对象、关键字还是其他东西? 最佳答案 您看到打印为Infinity和NaN的只是Float类的两个特殊实例的字符串
我不确定传递给方法的对象的类型是否正确。我可能会将一个字符串传递给一个只能处理整数的函数。某种运行时保证怎么样?我看不到比以下更好的选择:defsomeFixNumMangler(input)raise"wrongtype:integerrequired"unlessinput.class==FixNumother_stuffend有更好的选择吗? 最佳答案 使用Kernel#Integer在使用之前转换输入的方法。当无法以任何合理的方式将输入转换为整数时,它将引发ArgumentError。defmy_method(number)
我真的很习惯使用Ruby编写以下代码:my_hash={}my_hash['test']=1Java中对应的数据结构是什么? 最佳答案 HashMapmap=newHashMap();map.put("test",1);我假设? 关于java-等价于Java中的RubyHash,我们在StackOverflow上找到一个类似的问题: https://stackoverflow.com/questions/22737685/
我在理解Enumerator.new方法的工作原理时遇到了一些困难。假设文档中的示例:fib=Enumerator.newdo|y|a=b=1loopdoy[1,1,2,3,5,8,13,21,34,55]循环中断条件在哪里,它如何知道循环应该迭代多少次(因为它没有任何明确的中断条件并且看起来像无限循环)? 最佳答案 Enumerator使用Fibers在内部。您的示例等效于:require'fiber'fiber=Fiber.newdoa=b=1loopdoFiber.yieldaa,b=b,a+bendend10.times.m
我有用于控制用户任务的Rails5API项目,我有以下错误,但并非总是针对相同的Controller和路由。ActionController::RoutingError:uninitializedconstantApi::V1::ApiController我向您描述了一些我的项目,以更详细地解释错误。应用结构路线scopemodule:'api'donamespace:v1do#=>Loginroutesscopemodule:'login'domatch'login',to:'sessions#login',as:'login',via::postend#=>Teamroutessc
有时我需要处理键/值数据。我不喜欢使用数组,因为它们在大小上没有限制(很容易不小心添加超过2个项目,而且您最终需要稍后验证大小)。此外,0和1的索引变成了魔数(MagicNumber),并且在传达含义方面做得很差(“当我说0时,我的意思是head...”)。散列也不合适,因为可能会不小心添加额外的条目。我写了下面的类来解决这个问题:classPairattr_accessor:head,:taildefinitialize(h,t)@head,@tail=h,tendend它工作得很好并且解决了问题,但我很想知道:Ruby标准库是否已经带有这样一个类? 最佳