没有合适的资源？快使用搜索试试~ 我知道了~

首页Google Java编程风格规范的完整定义.pdf

Google Java编程风格规范的完整定义.pdf

Java

代码规范

编程规范

需积分: 9 16 下载量 170 浏览量更新于2023-05-17 评论 1 收藏 280KB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

试读

17页

这份PDF文档是Google Java编程风格规范的完整定义。当且仅当一个Java源文件符合此文档中的规则，我们才认为它符合Google的Java编程风格。

资源详情

资源评论

资源推荐

前言

这份文档是 Google Java 编程风格规范的完整定义。当且仅当一个 Java 源文件

符合此文档中的规则，我们才认为它符合 Google 的 Java 编程风格。

与其它的编程风格指南一样，这里所讨论的不仅仅是编码格式美不美观的问

题，同时也讨论一些约定及编码标准。然而，这份文档主要侧重于我们所普遍

遵循的规则，对于那些不是明确强制要求的，我们尽量避免提供意见。

1.1 术语说明

在本文档中，除非另有说明：

1. 术语 class 可表示一个普通类，枚举类，接口或是 annotation 类型

(@interface)

2. 术语 comment 只用来指代实现的注释(implementation comments)，我们

不使用“documentation comments”一词，而是用 Javadoc。

其他的术语说明会偶尔在后面的文档出现。

1.2 指南说明

本文档中的示例代码并不作为规范。也就是说，虽然示例代码是遵循 Google 编

程风格，但并不意味着这是展现这些代码的唯一方式。示例中的格式选择不应

该被强制定为规则。

源文件基础

2.1 文件名

源文件以其最顶层的类名来命名，大小写敏感，文件扩展名为.java。

2.2 文件编码：UTF-8

源文件编码格式为 UTF-8。

2.3 特殊字符

2.3.1 空白字符

除了行结束符序列，ASCII 水平空格字符(0×20，即空格)是源文件中唯一允许

出现的空白字符，这意味着：

1. 所有其它字符串中的空白字符都要进行转义。

2. 制表符不用于缩进。

2.3.2 特殊转义序列

对于具有特殊转义序列的任何字符(\b, \t, \n, \f, \r, \“, \‘及$$，我们

使用它的转义序列，而不是相应的八进制(比如 12)或 Unicode(比如\u000a)转

义。

2.3.3 非 ASCII 字符

对于剩余的非 ASCII 字符，是使用实际的 Unicode 字符(比如∞)，还是使用等

价的 Unicode 转义符(比如\u221e)，取决于哪个能让代码更易于阅读和理解。

Tip: 在使用 Unicode 转义符或是一些实际的 Unicode 字符时，建议做些注释给

出解释，这有助于别人阅读和理解。

例如：

String unitAbbrev = "μs"; | 赞，即使

没有注释也非常清晰

String unitAbbrev = "\u03bcs"; // "μs" | 允许，但

没有理由要这样做

String unitAbbrev = "\u03bcs"; // Greek letter mu, "s" | 允许，但

这样做显得笨拙还容易出错

String unitAbbrev = "\u03bcs"; | 很糟，读

者根本看不出这是什么

return '\ufeff' + content; // byte order mark | Good，对

于非打印字符，使用转义，并在必要时写上注释

Tip: 永远不要由于害怕某些程序可能无法正确处理非 ASCII 字符而让你的代码

可读性变差。当程序无法正确处理非 ASCII 字符时，它自然无法正确运行，你

就会去 fix 这些问题的了。(言下之意就是大胆去用非 ASCII 字符，如果真的有

需要的话)

源文件结构

一个源文件包含(按顺序地)：

1. 许可证或版权信息(如有需要)

2. package 语句

3. import 语句

4. 一个顶级类(只有一个)

以上每个部分之间用一个空行隔开。

3.1 许可证或版权信息

如果一个文件包含许可证或版权信息，那么它应当被放在文件最前面。

3.2 package 语句

package 语句不换行，列限制(4.4 节)并不适用于 package 语句。(即 package

语句写在一行里)

3.3 import 语句

3.3.1 import 不要使用通配符

即，不要出现类似这样的 import 语句：import java.util.*;

3.3.2 不要换行

import 语句不换行，列限制(4.4 节)并不适用于 import 语句。(每个 import 语

句独立成行)

3.3.3 顺序和间距

import 语句可分为以下几组，按照这个顺序，每组由一个空行分隔：

1. 所有的静态导入独立成组

2. com.google imports(仅当这个源文件是在 com.google 包下)

3. 第三方的包。每个顶级包为一组，字典序。例如：android, com,

junit, org, sun

4. java imports

5. javax imports

组内不空行，按字典序排列。

3.4 类声明

3.4.1 只有一个顶级类声明

每个顶级类都在一个与它同名的源文件中(当然，还包含.java 后缀)。

例外：package-info.java，该文件中可没有 package-info 类。

3.4.2 类成员顺序

类的成员顺序对易学性有很大的影响，但这也不存在唯一的通用法则。不同的

类对成员的排序可能是不同的。最重要的一点，每个类应该以某种逻辑去排序

它的成员，维护者应该要能解释这种排序逻辑。比如，新的方法不能总是习惯

性地添加到类的结尾，因为这样就是按时间顺序而非某种逻辑来排序的。

3.4.2.1 重载：永不分离

当一个类有多个构造函数，或是多个同名方法，这些函数/方法应该按顺序出现

在一起，中间不要放进其它函数/方法。

格式

术语说明：块状结构(block-like construct)指的是一个类，方法或构造函数

的主体。需要注意的是，数组初始化中的初始值可被选择性地视为块状结构

(4.8.3.1 节)。

4.1 大括号

4.1.1 使用大括号(即使是可选的)

大括号与 if, else, for, do, while 语句一起使用，即使只有一条语句(或是

空)，也应该把大括号写上。

4.1.2 非空块：K & R 风格

剩余16页未读，继续阅读

Google Java编程风格规范的完整定义

Exception in thread "main" java.lang.NoSuchMethodError: com.google.common.base.Preconditions.checkArgument(ZLjava/lang/String;Ljava/lang/Object;)V at org.apache.hadoop.conf.Configuration.set(Configuration.java:1357) at org.apache.hadoop.conf.Configurati

on.set(Configuration.java:1338) at org.apache.hadoop.util.GenericOptionsParser.parse(GenericOptionsParser.java:196) at org.apache.hadoop.util.GenericOptionsParser.parse(GenericOptionsParser.java:174...

at com.google.android.apps.gsa.shared.util.concurrent.a.ak.run(SourceFile:66) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1133) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:607) at java.lang.Thread.run(Thread.java:761)

1. 异常发生的地方：at com.google.android.apps.gsa.shared.util.concurrent.a.ak.run(SourceFile:66) 2. 异常类型：java.lang.OutOfMemoryError 3. 异常发生的原因：内存不足，导致程序无法继续执行。 4. 异常...

谷歌代码规范java

谷歌的Java编程风格规范是一份定义了编码规范和最佳实践的文档。它旨在提高代码的可读性、可维护性和可扩展性。以下是一些谷歌Java编程风格规范的要点： 1. 命名规范： - 类名使用大驼峰命名法，例如：MyClass。 ...

java.lang.IllegalStateException: Observer com.google.android.material.tabs.TabLayout$PagerAdapterObserver@8b3d524 was not registered. at android.database.Observable.unregisterObserver(Observable.java:69) at androidx.viewpager.widget.PagerAdapter.unregisterDataSetObserver(PagerAdapter.java:312) at com.google.android.material.tabs.TabLayout.setPagerAdapter(TabLayout.java:1506) at com.google.android.material.tabs.TabLayout$AdapterChangeListener.onAdapterChanged(TabLayout.java:3440) at androidx.viewpager.widget.ViewPager.setAdapter(ViewPager.java:549) at com.homily.classgroup.fragment.ClassNewsManagerFragment.initTableFragment(ClassNewsManagerFragment.java:96) at com.homily.classgroup.fragment.ClassNewsManagerFragment.access$300(ClassNewsManagerFragment.java:53) at com.homily.classgroup.fragment.ClassNewsManagerFragment$6.onNext(ClassNewsManagerFragment.java:308) at com.homily.classgroup.fragment.ClassNewsManagerFragment$6.onNext(ClassNewsManagerFragment.java:299) at io.reactivex.internal.operators.observable.ObservableObserveOn$ObserveOnObserver.drainNormal(ObservableObserveOn.java:201) at io.reactivex.internal.operators.observable.ObservableObserveOn$ObserveOnObserver.run(ObservableObserveOn.java:255) at io.reactivex.android.schedulers.HandlerScheduler$ScheduledRunnable.run(HandlerScheduler.java:124) at android.os.Handler.handleCallback(Handler.java:942) at android.os.Handler.dispatchMessage(Handler.java:99) at android.os.Looper.loopOnce(Looper.java:210) at android.os.Looper.loop(Looper.java:299) at android.app.ActivityThread.main(ActivityThread.java:8261) at java.lang.reflect.Method.invoke(Native Method) at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:559) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:954)怎么解决

```java ViewPager viewPager = findViewById(R.id.viewPager); TabLayout tabLayout = findViewById(R.id.tabLayout); MyPagerAdapter pagerAdapter = new MyPagerAdapter(getSupportFragmentManager()); viewPager...

Caused by: java.lang.NoClassDefFoundError: org/apache/flink/shaded/guava18/com/google/common/util/concurrent/ThreadFactoryBuilder at com.ververica.cdc.debezium.DebeziumSourceFunction.open(DebeziumSourceFunction.java:217) at org.apache.flink.api.common.functions.util.FunctionUtils.openFunction(FunctionUtils.java:34) at org.apache.flink.streaming.api.operators.AbstractUdfStreamOperator.open(AbstractUdfStreamOperator.java:101) at org.apache.flink.streaming.runtime.tasks.RegularOperatorChain.initializeStateAndOpenOperators(RegularOperatorChain.java:107) at org.apache.flink.streaming.runtime.tasks.StreamTask.restoreGates(StreamTask.java:734) at org.apache.flink.streaming.runtime.tasks.StreamTaskActionExecutor$SynchronizedStreamTaskActionExecutor.call(StreamTaskActionExecutor.java:100) at org.apache.flink.streaming.runtime.tasks.StreamTask.restoreInternal(StreamTask.java:709) at org.apache.flink.streaming.runtime.tasks.StreamTask.restore(StreamTask.java:675) at org.apache.flink.runtime.taskmanager.Task.runWithSystemExitMonitoring(Task.java:952) at org.apache.flink.runtime.taskmanager.Task.restoreAndInvoke(Task.java:921) at org.apache.flink.runtime.taskmanager.Task.doRun(Task.java:745) at org.apache.flink.runtime.taskmanager.Task.run(Task.java:562) at java.lang.Thread.run(Thread.java:748) Caused by: java.lang.ClassNotFoundException: org.apache.flink.shaded.guava18.com.google.common.util.concurrent.ThreadFactoryBuilder at java.net.URLClassLoader.findClass(URLClassLoader.java:381) at java.lang.ClassLoader.loadClass(ClassLoader.java:424) at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:349) at java.lang.ClassLoader.loadClass(ClassLoader.java:357) ... 13 more 这是什么报错信息

具体来说，这个错误信息表明在程序运行时，Java 找不到一个名为 `org.apache.flink.shaded.guava18.com.google.common.util.concurrent.ThreadFactoryBuilder` 的类。这个类可能是某个依赖库中的类，但是这个依赖库...

gts java 通用编程规范考试

gts (Google Technology Stack) Java 通用编程规范考试旨在测试开发人员对于使用Java进行编程时的规范性和最佳实践的掌握程度。考试要求考生熟悉和遵守Google推荐的编程规范，代码风格，以及常见的设计模式和技术栈...

at redis.clients.jedis.CommandObjects.<clinit>(CommandObjects.java:3984) at redis.clients.jedis.Jedis.<init>(Jedis.java:39) at jedis1.JedisTest.main(JedisTest.java:13) Caused by: java.lang.ClassNotFoundException: com.google.gson.Gson at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:520) ... 3 more

这个错误提示是因为你缺少了 com.google.gson.Gson 类的依赖。你需要在你的项目中添加 Gson 的依赖，具体方法取决于你使用的构建工具。如果你使用 Maven，可以在 pom.xml 文件中添加以下依赖： ``` <groupId>...

谷歌java 代码规范pdf

谷歌Java代码规范是谷歌公司为了统一Java代码风格而编写的一份规范文档。这份文档的目的是帮助开发人员编写出易读、易维护、高效的Java代码。这个文档主要包括代码布局、命名规范、注释规范、代码风格等方面的指导。...

c++高效编程--内存与性能优化.pdf 下载

要下载 "高效编程--内存与性能优化.pdf" ，您可以按照以下步骤进行操作： 1. 打开一个网络浏览器，例如Chrome、Safari或Firefox。 2. 在地址栏中输入文档的名称 "高效编程--内存与性能优化.pdf" ，并按下回车键进行...

E/AndroidRuntime: FATAL EXCEPTION: main Process: com.example.photodiary, PID: 14460 android.content.ActivityNotFoundException: Unable to find explicit activity class {com.example.photodiary/com.example.photodiary.CameraX}; have you declared this activity in your AndroidManifest.xml? at android.app.Instrumentation.checkStartActivityResult(Instrumentation.java:2049) at android.app.Instrumentation.execStartActivity(Instrumentation.java:1709) at android.app.Activity.startActivityForResult(Activity.java:5192) at androidx.activity.ComponentActivity.startActivityForResult(ComponentActivity.java:597) at android.app.Activity.startActivityForResult(Activity.java:5150) at androidx.activity.ComponentActivity.startActivityForResult(ComponentActivity.java:583) at android.app.Activity.startActivity(Activity.java:5521) at android.app.Activity.startActivity(Activity.java:5489) at com.example.photodiary.Diary$1.onClick(Diary.java:37) at android.view.View.performClick(View.java:7125) at com.google.android.material.button.MaterialButton.performClick(MaterialButton.java:1131) at android.view.View.performClickInternal(View.java:7102) at android.view.View.access$3500(View.java:801) at android.view.View$PerformClick.run(View.java:27336) at android.os.Handler.handleCallback(Handler.java:883) at android.os.Handler.dispatchMessage(Handler.java:100) at android.os.Looper.loop(Looper.java:214) at android.app.ActivityThread.main(ActivityThread.java:7356) at java.lang.reflect.Method.invoke(Native Method) at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:492) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:930)

这个报错提示说在 AndroidManifest.xml 文件中没有声明 CameraX 这个 Activity。你需要在 AndroidManifest.xml 文件中声明该 Activity，像这样...注意，需要将 `android:name` 的值设置为你的 CameraX 类的完整路径名。

imgui.pdf pdf 网盘

imgui.pdf是一种文件格式，常用于存储和传输可编辑的矢量图形和文档。PDF代表Portable Document Format（便携式文档格式），它可以在不同的操作系统和设备上保留文件原始格式和布局的能力。imgui.pdf文件可以使用...

java给pdf加超链接

Java可以使用iText库来给PDF文件添加超链接。具体操作步骤如下： 1. 首先，你需要在项目中引入iText库。你可以在maven仓库中搜索iText，然后将其添加到你的项目依赖中。 2. 然后，你需要创建一个PdfWriter对象和一...

E/AndroidRuntime: FATAL EXCEPTION: main Process: com.example.photodiary, PID: 32496 java.lang.NullPointerException: Attempt to invoke virtual method 'int android.util.Size.getWidth()' on a null object reference at com.example.photodiary.Diary.createPreviewSession(Diary.java:139) at com.example.photodiary.Diary.access$100(Diary.java:44) at com.example.photodiary.Diary$1.onClick(Diary.java:75) at android.view.View.performClick(View.java:7125) at com.google.android.material.button.MaterialButton.performClick(MaterialButton.java:1131) at android.view.View.performClickInternal(View.java:7102) at android.view.View.access$3500(View.java:801) at android.view.View$PerformClick.run(View.java:27336) at android.os.Handler.handleCallback(Handler.java:883) at android.os.Handler.dispatchMessage(Handler.java:100) at android.os.Looper.loop(Looper.java:214) at android.app.ActivityThread.main(ActivityThread.java:7356) at java.lang.reflect.Method.invoke(Native Method) at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:492) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:930)

这是一个 Android 运行时错误，具体是在 `com.example.photodiary.Diary.createPreviewSession` 方法中的第 139 行，尝试在一个空对象引用上调用 `getWidth()` 方法。这意味着你需要检查代码中是否有一个 `null` ...

2023-06-01 17:16:20 java.lang.NoClassDefFoundError: org/apache/flink/shaded/guava18/com/google/common/util/concurrent/ThreadFactoryBuilder at com.ververica.cdc.debezium.DebeziumSourceFunction.open(DebeziumSourceFunction.java:217) at org.apache.flink.api.common.functions.util.FunctionUtils.openFunction(FunctionUtils.java:34) at org.apache.flink.streaming.api.operators.AbstractUdfStreamOperator.open(AbstractUdfStreamOperator.java:101) at org.apache.flink.streaming.runtime.tasks.RegularOperatorChain.initializeStateAndOpenOperators(RegularOperatorChain.java:107) at org.apache.flink.streaming.runtime.tasks.StreamTask.restoreGates(StreamTask.java:734) at org.apache.flink.streaming.runtime.tasks.StreamTaskActionExecutor$SynchronizedStreamTaskActionExecutor.call(StreamTaskActionExecutor.java:100) at org.apache.flink.streaming.runtime.tasks.StreamTask.restoreInternal(StreamTask.java:709) at org.apache.flink.streaming.runtime.tasks.StreamTask.restore(StreamTask.java:675) at org.apache.flink.runtime.taskmanager.Task.runWithSystemExitMonitoring(Task.java:952) at org.apache.flink.runtime.taskmanager.Task.restoreAndInvoke(Task.java:921) at org.apache.flink.runtime.taskmanager.Task.doRun(Task.java:745) at org.apache.flink.runtime.taskmanager.Task.run(Task.java:562) at java.lang.Thread.run(Thread.java:748)

这是一个Java程序的错误信息，具体是因为找不到类 "org/apache/flink/shaded/guava18/com/google/common/util/concurrent/ThreadFactoryBuilder" 导致的。这个类可能是由于缺少依赖项或版本不匹配而找不到。你可以...

Java编程风格

Java编程风格(英汉对照)，不用介绍，很经典。中英文各一份，很有价值。

Alvin_lin

粉丝: 0
资源: 7

上传资源快速赚钱

我的内容管理收起

我的资源快来上传第一个资源

我的收益

登录查看自己的收益

我的积分登录查看自己的积分

我的C币登录后查看C币余额

我的收藏

我的下载

下载帮助

会员权益专享

Google Java编程风格规范的完整定义.pdf

评论0

会员权益专享

最新资源

Google Java编程风格规范的完整定义.pdf

评论0

Google Java编程风格规范的完整定义

Google出品的Java编码规范，强烈推荐！

Google Java 编程规范（中文版）.pdf

spire.pdf.jar 下载

Exception in thread "main" java.lang.NoSuchMethodError: com.google.common.base.Preconditions.checkArgument(ZLjava/lang/String;Ljava/lang/Object;)V at org.apache.hadoop.conf.Configuration.set(Configuration.java:1357) at org.apache.hadoop.conf.Configurati

at com.google.android.apps.gsa.shared.util.concurrent.a.ak.run(SourceFile:66) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1133) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:607) at java.lang.Thread.run(Thread.java:761)

谷歌代码规范java

gts java 通用编程规范考试

谷歌java 代码规范pdf

c++高效编程--内存与性能优化.pdf 下载

imgui.pdf pdf 网盘

java给pdf加超链接

最新-Google java编码规范指南-中文版

Java编程风格

会员权益专享

最新资源