作者： 扇贝

在Java中注释的英文为Comment。而注解的英文是Annotation。

虽然注解和注释一样，也是在源代码中添加额外的补充信息。但注解都是以@开头的。

注解可以在类、字段变量、方法、接口等位置进行标记。主要为后续一些诸如：代码生成、数据校验、资源整合等工作进行铺垫。

基本注解

例如一段代码：

@Override
public String toString() {
    return "Hello World";
}

这段代码是表示重写了父类的toString()方法。如果不使用@Override代码也可以正常执行。但使用了@Override代表告诉编译器这是一个重写方法。如果我们把方法名打错，就提前报错。这可以在前期排除一些简单的问题。

如果代码不加@Override，那在我们把方法名打错的情况，这个方法就变成一个普通的方法，而不是重写方法。

注解本身是一种数据类型，是一种接口类型。是一种语法糖，其中复杂的过程由编译器来帮我们完成。

直到Java11共有11个内置注解。其中有 5 个是基本注解，它们来自于 java.lang 包。有 6 个是元注解，它们来自于 java.lang.annotation 包，自定义注解会用到元注解。

• @Override表示重写方法
• @Deprecated表示弃用方法
• @SuppressWarnings用于抑制警告
• @SafeVarargs用于抑制警告
• @FunctionalInterface用于指定接口，保证该接口只能包含一个抽象方法。

在Java的文档注释中同样也有@deprecated，仅仅差了一个开头的大小写。虽然两者的目的差不多，都是为了表示该方法已经过时。但两者的作用却不一样文档注释作用与文档，编译器不会给出警告，注释也不直接作用于程序。而注解是直接用于修饰程序中的程序单元，如方法、类和接口等。并且注解是Java5之后才开始支持。而文档注释仅仅在程序外整理。

元注解

元注解是负责对其它注解进行说明的注解。

Java5定义了4个注解，分别是@Documented、@Target、@Retention 和 @Inherited。Java8又增加了@Repeatable和@Native两个注解。

自定义注解

基本注解和元注解，如果这两种注解不能满足你的需求，可以自定义注解。

不包含任何成员变量的注解称为标记注解，例如基本注解中的@Override注解就属于标记注解。

包含成员变量的注解称为元数据注解，因为它们可以接受更多的元数据。

注解的用法

注解的实现的原理很大的一部分是基于反射实现。

使用反射获取到类对象，进而获取构造器、字段和方法等。在源码中，类、构造器、字段和方法等均实现了AnnotatedElement接口。而这个接口包含了关于注解的一些方法。

可以通过反射来获取某个类或方法是否拥有注解。注解了些什么。需要按照这些注解整形那些步骤。

注解是一种分散式的元数据，与源代码绑定。

xml是一种集中式的元数据，与源代码无绑定。

在Java后台的开发过程中，服务器的配置项大多会存放在一个xml文件中，而Spring基于注解进行配置，从而替代了配置文件的功能。两者各有好处也有缺点。

注解有几个主要用途：

• 生成文档，通过代码里标识的元数据生成javadoc文档。
• 编译检查，通过代码里标识的元数据让编译器在编译期间进行检查验证。
• 编译时动态处理，编译时通过代码里标识的元数据动态处理，例如动态生成代码。
• 运行时动态处理，运行时通过代码里标识的元数据动态处理，例如使用反射注入实例

参考：

听说你只会用注解，不会自己写注解？

java注解的使用

##代码风格

##次行风格和尾行风格

块的写法有两种常用方式：次行（next-line) 风格和行尾（end-of-line) 风格。

public class Test
{
	public static void main(String[] args)
	{
		System.out.println("Block Styles");
	}
}

public class Test{
	public static void main(String[] args){
		System.out.println("Block Styles");
	}
}

次行风格将括号垂直对齐，因而使程序容易阅读；而行尾风格更节省空间，并有助于避
免犯一些细小的程序设计错误。这两种风格都是可以采纳的。

类型

对于强类型语言，我们需要先定义变量类型，再使用变量。

这让我不禁让我想到去吃的肯德基疯狂星期四。肯德基的疯狂星期四里面有8个蛋挞的套餐。通常一盒蛋挞是两个装。因此如果你点了疯狂星期四的套餐，你会收到四个蛋挞盒，共计八个蛋挞。

也就是说，如果你是店员，你需要准备四个盒子来装8个蛋挞。

对于肯德基的店员来说，一个店员能装的蛋挞数量，这是拿到的盒子限制的；但一个盒子只能装两个蛋挞，这是盒子大小限制的；而盒子大小是肯德基规定的。

对于计算机的数据来说，一个整形能存储的数据大小，这是字节数限制的；但一个字节最多能存储255的正整数，这是字节大小限制的（也就是8位）；而字节大小是计算机行业规定的。

但肯德基和计算机还有一个很大的不同，就是进制和统计的不同。

肯德基是十进制，四个盒子分别是2、2、2、2。这四个盒子是分别计算。

肯德基合计是2+2+2+2=8，这符合我们的常理。因为我们是分开计算的。

计算机是十六进制，四个字节分别是FF、FF、FF、FF。这四个字节是在一个整体中，为0xFFFFFFFF。

计算机合计是255+65280+16711680+4278190080=4294967295。

因此计算机显得不是那么好看。

泛型

对于面向对象也是，我们总说先定义对象类型，再实例化和使用对象。

但类型并不是对象，而是对象的模板。

假设我们的程序在单线程环境中有一段代码。我们把这段代码看作是一个面包店中一台烘焙饼干的机器。但这家面包店由于电力负载问题，一次只能有一台烘焙饼干的机器在运行。

最开始，人们发明了一个烘焙饼干的机器，但这个机器只能制作小熊形状的饼干。突然人们想吃小兔饼干，于是又发明了另一个机器，但这个机器只能制作小兔形状的饼干。

人们希望有更多的饼干形状。于是出现了越来越多的机器，用于生产不同形状的饼干。这些机器功能都非常单一，一种机器只能生产一种形状的饼干。这些机器有很多非常不方便的地方。我们以小熊饼干机器为例：

• 机器内部有很多个小熊模具，用于压出饼干形状。如果希望制作有小兔饼干就必须全部替换机器中的小熊模具。
• 假设制作小熊饼干的机器有潜在问题，那其他所有制作不同形状饼干的机器也可能有潜在问题。
• 这些不同的机器占据了非常大的空间位置。
• 维护这些机器非常的复杂和繁琐。

于是人们希望有这样一种机器——这个机器有一个卡槽，在卡槽中放入需要的模具，就可以生成需要形状的饼干。这样只需要一台机器，在适当的时候放入模具，就可以生产需要形状的饼干了。

之后机器真的发明出来了，人们称这台机器为泛型烘焙机。因为它是泛用的。放入小熊模具后，这机器就变成小熊饼干烘焙机；放入小兔模具，这机器就变成小兔饼干烘焙机。

对于程序来说，类型就像是一个烘培用的小熊饼干模具，它本身并不能食用。而用这个模具做出来的小熊饼干才是我们需要的对象，这个对象才有耳朵、有身体躯干、有它的香味、并且可以食用。

因此，泛型更像是类型的模板，也就是模具的模板。我们可以使用小熊模具制造小熊饼干，也可以使用兔子模具制造兔子饼干。我们只需要在卡槽中替换模具就行了。而这个替换模具的位置就是泛型。

泛型就像是占位符，就像泛型烘焙机中放置模具的位置。

搭建SVN服务器与客户端

服务器使用VisualSVN，而客户端使用TortoiseSVN。

首先，需要有一台主机安装VisualSVN，这台主机将作为服务器，为下游客户端提供版本控制服务。而下游的客户端需要安装TortoiseSVN来使用服务器提供的服务。

服务器

服务器安装

下面是VisualSVN的官网。

Subversion Server for Windows | VisualSVN Server

你可以在这里先查看VisualSVN不同版本的价格和对应的功能。当然也可以只使用免费的社区版。

Pricing | VisualSVN Server

下面是VisualSVN官网的下载地址。可以自行选择需要的版本。

Download | VisualSVN Server

你可以在下面的链接中找到官方的安装流程。在安装过程中可能会出现Select the authentication mode，也就是选择身份验证模式。如果选择Use Windows authentication则需要提供许可证密钥。在安装时需要注意。

Getting Started | VisualSVN Server

服务器配置

在VisualSVN安装完成之后，我们需要先配置服务器的网络环境。之后创建供客户端使用的存储库。

配置服务器的网络环境可以参考下面的文章。

SVN服务器远程访问 – 简书 (jianshu.com)

存储库的搭建可以参考下面的文章。

搭建SVN服务器详细教程

如果使用Windows身份验证模式，可以在安装后，查看官网的这篇文章进行配置。

How to configure Integrated Windows Authentication in VisualSVN Server | VisualSVN Help Center

客户端

下面是TortoiseSVN的官网。

Home · TortoiseSVN

下面是TortoiseSVN的下载地址。可以自行选择需要的版本。

Downloads · TortoiseSVN

安装的TortoiseSVN默认是英文的，如果需要中文，可以在下面的网址选择对应版本的汉化包进行安装。

Downloading File / – TortoiseSVN – OSDN

对汉化流程不熟悉的可以查看下面的文章。

解决SVN安装语言包后无法选择中文的问题。

在客户端中安装TortoiseSVN完成后，可以直接使用存储库的URL进行访问。

### C#中特性（Attribute）的用法。

特性其实类似于修饰器，在方法执行的前后可以额外执行其他的代码，而不需要主动去做额外的设计。

其用法其实就是在类或方法前加上[Attribute()]。

using System; 
public class AnyClass
{
    [Obsolete("Don't use Old method, use New method", true)]
    static void Old() { }

    static void New() { }

    public static void Main()
    {
        Old();
    }
}

上面这个例子，在这个例子中我们使用了Obsolete特性，它标记了一个不应该再被使用的程序实体。

第一个参数是一个字符串，它解释了 为什么该实体是过时的以及应该用什么实体来代替它。实际上，你可以在这里写任何文本。第二个参数告诉编译器应该把使用这个过时的程序实体当作一种错误。它的默认值是false，也就是说编译器对此会产生一个警告。

当我们尝试编译上面这段程序的时候，我们将会得到一个错误：

AnyClass.Old()' is obsolete: 'Don't use Old method, use New method'

我们也可以自己实现特性。首先要从System.Attribute派生出我们自己的特性类（一个从System.Attribute抽象类继承而来的类，不管是直接还是间接继承，都会成为一个特性类。特性类的声明定义了一种可以被放置在声明之上新的特性）。

using System; 
public class HelpAttribute : Attribute
{

}

[Help()]
public class AnyClass
{

}

注意：对一个特性类名使用Attribute后缀是一个惯例。当我们把特性添加到一个程序实体，是否包括Attribute后缀是我们的自由。编译器会首先在System.Attribute的派生类中查找被添加的特性类。如果没有找到，那么编译器会添加Attribute后缀继续查找。

接下来把上面的特性添加到具体的程序实体中。

using System; 
public class HelpAttribute : Attribute
{
    public HelpAttribute(String Descrition_in)
    {
        this.description = Description_in;
    }
    protected String description;
    public String Description
    {
        get
        {
            return this.description;

        }
    }
}

[Help("this is a do-nothing class")]
public class AnyClass
{

}

在这个例子中，我们给HelpAttribute特性类添加了一个属性并且在后续的部分中会在运行时环境中查寻它。