@param

    @ param标签可以归档方法或构造器的某个单一参数,或者归档类、接口以及泛型方法的类型参数。在使用@ param标签时,我们应该针对方法的每一个参数都使用一个该标签。每个段落的第一个词会被当作参数名,而余下的部分则会被当作是对它的描述:


      @param max The maximum number of words to read.


      当归档类型参数时,我们应该在类型参数名两边加上<和>:


发布: 2015-9-25 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

{@ link}和{@ linkplain}


      @see标签对于文档末尾生成的“另见”(see also)部分很有用。当交叉引用应该归属到注释文本中时,我们就可以在文本中嵌人行间标签{@link},@link的语法是:


      (@ link package. class*nember (laben)


      其中,标识符的规范与@ see相同,而可选的label也是一样的。下面的句子中嵌人了一个指向getvalue方法的链接:


发布: 2015-9-25 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

@ see

    @ see标签可以创建链接到其他javadoc文档的交叉引用。我们可以在该标签的后面命名任何标识符,尽管我们必须对它们进行充分的限定。例如,通常可以使用某个类的成员的简单名来命名它,但是如果该成员是一个重载方法,我们就必须通过列举各个参数的类型来指定该方法的重载版本。我们可以使用未限定的名字来指定当前包内的接口或类,但必须使用完全限定名来指定其他包中的类型。我们可以通过在成员名的前面使用#来指定类型的成员。下面是所有有效的@ see标签格式:


      @see #getName

发布: 2015-9-23 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

java@标签

    文档注释可以含有标签,这些标签持有特定种类的信息。标签可以以两种形式出现:


      .块标签(block tag)定义了独立的文本元素。所有这种标签都以尽开头,比如@see或@deprecated。这些段落会在自动生成的文档中受到特殊处理,从而生成被标记的段落、指向其他文档的链接或其他的特殊处理结果。本节将介绍除了@ serial,@ serialDa-to和@ serialField之外的所有标签,这三个标签与对象序列化有关,它们将在“obj ect字节流”中进行描述。

发布: 2015-9-23 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

剖析文档注释

    文档注释以三个字符/**开始,直到*/结束,每个文档注释都对紧随其后声明的标识符进行了描述。文档注释各行开头的*字符将被忽略,而*之前的空白分隔符部分也会被忽略。注释中的第一个句子是有关标识符的摘要,“句子”是指第一个后面跟随空白分隔符的句点之前


      的所有文本。考虑如下的文档注释:


      /**


      *Do what the invoker intends."Intention" is defined by

发布: 2015-9-23 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

包对象和规范

    包通常会实现某种规范,并且通常是来自于某个组织的。Package对象与其他的反射类型不同,不能用来创建或操作包,而只能充当提供信息的知识库,用来提供有关包所实现的规范的信息(规范的标题、供应商和版本号)和有关包的实现本身的信息(包的标题、供应商和版本号)。虽然包通常来自于单个的组织,但它所实现的规范(如统计分析库)却可能是其他组织已定义过的。使用包的程序可能需要知道该包所实现的规范的版本,从而可以使用只在某个版本中定义的功能。类似地,这些程序还可能需要知道提供给它的是哪个实现版本,这主要是为了处理在不同版本中可能存在的缺陷。Package类的一些主要方法允许访问到这些信息:

发布: 2015-9-11 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

包的内容

    包的内容应该仔细设计,使其只包含在功能上相关的类和接口。包中的类可以自由地访问该包中其他类的非私有成员,有些类甚至可能有足够的权限去访问其他类的内部细节,为了避免这样的类对类成员进行误操作,我们需要对类成员进行保护。任何没有被声明为private的成员都可以被同一个包中的其他所有类型访问,所以任何不相关的类之间的藕合程度都可能会比我们所期望的程度高。


      包还为寻找有用的接口和类的程序员提供了逻辑分组的功能。由不相关的类组成的包使程序员很难分辨出哪些接口和类是有用的,而类的逻辑分组可以帮助程序员重用代码,因为程序员通过逻辑分组能够更容易地找到他们所需要的东西。如果包中只包含相关的、紧藕合的类型集,则意味着我们可以给类型取一些更直观的名字,从而避免名字冲突。

发布: 2015-9-11 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

包的访问

    在声明包中的顶层类和顶层接口的可访问性时,有两种选择:包访问权限(package)和公共访问权限(public)。用public修饰的类或接口可以被包外的代码所访问,而没有用public修饰的类型则具有包作用域:它们可以被同一个包中的其他代码所访问;但对于包外的代码,甚至是子包中的代码,它们都是隐藏的。我们在声明类型时,应该只把其他程序员需要使用的那些类型声明为public的,而隐藏那些属于包的实现细节的类型。这种技术给我们提供了极大的灵活性,由于程序员并不依赖于这些他们所不能访问的实现细节的类型,所以当我们想改变实现细节时,可以自由地改变它们。

发布: 2015-9-9 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

类型导入

    类型导人是更泛化的静态导人(我们已经学习过静态导人),通过使用类型导人,我们就可以使用类型的简单名来引用类型,而不需要写出它们的完全限定名(fully qualifiedname)。


      当我们在包外编写的代码需要使用这个包的内部声明的类型时,我们有两种选择,第一种是使用类型的完全限定名。如果我们仅仅使用了包内的少数几种类型,那么这种选择就是合理的。但是包越来越趋向于采用较长的名字(标准库中的名字相对短一些),因此使用完全限定名是相当冗长乏味的。


发布: 2015-9-9 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次

包的命名

    包的名字应该避免与其他包冲突,所以选择一个既有意义又唯一的名字是包设计的一个重要方面。但是全球的程序员都在开发包,根本就没有办法获知谁采用了什么包名,因此选择唯一的包名是一个难题。如果我们确定某个包只在我们的组织内部使用,那么我们就可以让内部仲裁者(internal arbiter)来确保项目之间不会发生名字冲突。


      但是对于整个世界而言,这种方法是不实际的。包的标识符都是简单的名字,一种比较好的能够确保包名唯一的方法是使用Internet域名。如果我们所就职的公司的名字为Magic.lnc,该公司的域名为magi c.com,那么属性包的声明就应该是:

发布: 2015-9-9 分类: java数据结构和算法,java排序算法,java数据结构, 阅读: 次 评论: 0次
搜狗
百度位
360
最近发表
Tags列表
友情链接
控制面板
您好,欢迎到访网站!
  [查看权限]