3.3 import语句
3.2 package语句package语句不换行,列限制(4.4节)并不适用于package语句。(即package语句写在一行里)
3.1 许可证或版权信息如果一个文件包含许可证或版权信息,那么它应当被放在文件最前面。
一个源文件包含(按顺序地):许可证或版权信息(如有需要)package语句import语句一个顶级类(只有一个)以上每个部分之间用一个空行隔开。
2.3.3 非ASCII字符对于剩余的非ASCII字符,是使用实际的Unicode字符(比如∞),还是使用等价的Unicode转义符(比如\u221e),取决于哪个能让代码更易于阅读和理解。Tip: 在使用Unicode转义符或是一些实际的Unicode字符时,建议做些注释给出解释,这有助于别人阅读和理解。例如:String unitAbbrev = "μs";
2.3.2 特殊转义序列对于具有特殊转义序列的任何字符(\b, \t, \n, \f, \r, \“, \‘及),我们使用它的转义序列,而不是相应的八进制(比如\012)或Unicode(比如\u000a)转义。
2.3.1 空白字符除了行结束符序列,ASCII水平空格字符(0x20,即空格)是源文件中唯一允许出现的空白字符,这意味着:所有其它字符串中的空白字符都要进行转义。制表符不用于缩进。
2.3 特殊字符
2.2 文件编码:UTF-8源文件编码格式为UTF-8。
2.1 文件名源文件以其最顶层的类名来命名,大小写敏感,文件扩展名为.java。
1.2 指南说明本文档中的示例代码并不作为规范。也就是说,虽然示例代码是遵循Google编程风格,但并不意味着这是展现这些代码的唯一方式。 示例中的格式选择不应该被强制定为规则。
1.1 术语说明在本文档中,除非另有说明:术语class可表示一个普通类,枚举类,接口或是annotation类型(@interface)术语comment只用来指代实现的注释(implementation comments),我们不使用“documentation comments”一词,而是用Javadoc。其他的术语说明会偶尔在后面的文档出现。
这份文档是Google Java编程风格规范的完整定义。当且仅当一个Java源文件符合此文档中的规则, 我们才认为它符合Google的Java编程风格。与其它的编程风格指南一样,这里所讨论的不仅仅是编码格式美不美观的问题, 同时也讨论一些约定及编码标准。然而,这份文档主要侧重于我们所普遍遵循的规则, 对于那些不是明确强制要求的,我们尽量避免提供意见。
Google Java编程风格规范 gitbook 版本,内容来至Hastein的中文翻译。作者:Hawstein出处:http://hawstein.com/posts/google-java-style.html
当学习了 Java NIO 和 IO 的 API 后,一个问题马上涌入脑海:我应该何时使用 IO,何时使用 NIO 呢?在本文中,我会尽量清晰地解析 Java NIO 和 IO 的差异、它们的使用场景,以及它们如何影响您的代码设计。Java NIO 和 IO 的主要区别下表总结了 Java NIO 和 IO 之间的主要差别,我会更详细地描述表中每部分的差异。
Java NIO 管道是 2 个线程之间的单向数据连接。Pipe有一个 source 通道和一个 sink 通道。数据会被写到 sink 通道,从 source 通道读取。这里是 Pipe 原理的图示:创建管道通过Pipe.open()方法打开管道。例如:Pipe pipe = Pipe.open();向管道写数据要向管道写数据,需要访问 sink 通道。像这样:Pipe.SinkChannel sinkChannel = pipe.sink();
Java NIO 中的 DatagramChannel 是一个能收发 UDP 包的通道。因为 UDP 是无连接的网络协议,所以不能像其它通道那样读取和写入。它发送和接收的是数据包。打开 DatagramChannel下面是 DatagramChannel 的打开方式:DatagramChannel channel = DatagramChannel.open();channel.socket().bind(new InetSocketAddress(9999));
Java NIO 中的 ServerSocketChannel 是一个可以监听新进来的 TCP 连接的通道, 就像标准 IO 中的 ServerSocket 一样。ServerSocketChannel 类在 java.nio.channels 包中。这里有个例子:ServerSocketChannel serverSocketChannel = ServerSocketChannel.open();serverSocketChannel.socket().bind(new InetSocketAddress(9999));
关注时代Java