用 Google Guava 工具库创建本地缓存

Guava是一个Google开源的Java核心库，它提供了许多实用的工具和辅助类，使Java开发更加简洁、高效、可靠。目前和hutool一起，是业界常用的工具类库。

Google Cloud Platform

Google Compute Enginer 镜像快速入门1.去谷歌云控制台，创建一个新的云计算项目，启用云引擎2.使用如下的命令来下载谷歌云 SDK 并配置您的项目： $ curl https://sdk.cloud.google.com | bash $ gcloud auth login $ gcloud config set project <google-cloud-project-id>3.

Google Guava 工具库的常用方法

Guava是Google发布的一个开源库，主要提供了一些在Java开发中非常有用的工具类和API，比如字符串处理、集合操作、函数式编程、缓存等等。不管是工作还是学习都是非常值得我们去熟悉的，一起来看看吧。

Google Guava 官方教程

Guava 工程包含了若干被 Google 的 Java 项目广泛依赖 的核心库，例如：集合 [collections] 、缓存 [caching] 、原生类型支持 [primitives support] 、并发库 [concurrency libraries] 、通用注解 [common annotations] 、字符串处理 [string processing] 、I/O 等等。 所有这些工具每天都在被 Google 的工程师应用在产品服务中。

可选的Javadoc

7.3.3 可选的Javadoc对于包外不可见的类和方法，如有需要，也是要使用Javadoc的。如果一个注释是用来定义一个类，方法，字段的整体目的或行为， 那么这个注释应该写成Javadoc，这样更统一更友好。

例外：重载

7.3.2 例外：重载如果一个方法重载了超类中的方法，那么Javadoc并非必需的。

例外：不言自明的方法

7.3.1 例外：不言自明的方法对于简单明显的方法如getFoo，Javadoc是可选的(即，是可以不写的)。这种情况下除了写“Returns the foo”，确实也没有什么值得写了。单元测试类中的测试方法可能是不言自明的最常见例子了，我们通常可以从这些方法的描述性命名中知道它是干什么的，因此不需要额外的文档说明。

哪里需要使用Javadoc

7.3 哪里需要使用Javadoc至少在每个public类及它的每个public和protected成员处使用Javadoc，以下是一些例外：

摘要片段

7.2 摘要片段每个类或成员的Javadoc以一个简短的摘要片段开始。这个片段是非常重要的，在某些情况下，它是唯一出现的文本，比如在类和方法索引中。这只是一个小片段，可以是一个名词短语或动词短语，但不是一个完整的句子。它不会以A {@code Foo} is a...或This method returns...开头, 它也不会是一个完整的祈使句，如Save the record...。

Javadoc标记

7.1.3 Javadoc标记标准的Javadoc标记按以下顺序出现：@param, @return, @throws, @deprecated, 前面这4种标记如果出现，描述都不能为空。 当描述无法在一行中容纳，连续行需要至少再缩进4个空格。

段落

7.1.2 段落空行(即，只包含最左侧星号的行)会出现在段落之间和Javadoc标记(@XXX)之前(如果有的话)。 除了第一个段落，每个段落第一个单词前都有标签<p>，并且它和第一个单词间没有空格。

一般形式

7.1.1 一般形式Javadoc块的基本格式如下所示：/** * Multiple lines of Javadoc text are written here, * wrapped normally... */public int method(String p1) { ... }或者是以下单行形式：/** An especially short bit of Javadoc. */基本格式总是OK的。当整个Javadoc块能容纳于一行时(且没有Javadoc标记@XXX)，可以使用单行形式。

格式

7.1 格式

Javadoc

Finalizers: 禁用

6.4 Finalizers: 禁用极少会去重载Object.finalize。Tip：不要使用finalize。如果你非要使用它，请先仔细阅读和理解Effective Java 第7条款：“Avoid Finalizers”，然后不要使用它。

静态成员：使用类进行调用

6.3 静态成员：使用类进行调用使用类名调用静态的类成员，而不是具体某个对象或表达式。Foo aFoo = ...;Foo.aStaticMethod(); // goodaFoo.aStaticMethod(); // badsomethingThatYieldsAFoo().aStaticMethod(); // very bad

捕获的异常：不能忽视

6.2 捕获的异常：不能忽视除了下面的例子，对捕获的异常不做响应是极少正确的。(典型的响应方式是打印日志，或者如果它被认为是不可能的，则把它当作一个AssertionError重新抛出。)如果它确实是不需要在catch块中做任何响应，需要做注释加以说明(如下面的例子)。try { int i = Integer.parseInt(response); return handleNumericResponse(i);

@Override：能用则用

6.1 @Override：能用则用只要是合法的，就把@Override注解给用上。

编程实践

驼峰式命名法(CamelCase)

5.3 驼峰式命名法(CamelCase)驼峰式命名法分大驼峰式命名法(UpperCamelCase)和小驼峰式命名法(lowerCamelCase)。 有时，我们有不只一种合理的方式将一个英语词组转换成驼峰形式，如缩略语或不寻常的结构(例如"IPv6"或"iOS")。Google指定了以下的转换方案。名字从散文形式(prose form)开始:把短语转换为纯ASCII码，并且移除任何单引号。