日撸 Java 三百行（03天，注释，基本if语句与函数调用）

日撸 Java 三百行（03天，注释，基本if语句与函数调用）

注意：这里是JAVA自学与了解的同步笔记与记录，如有问题欢迎指正说明

---

一、关于注释的说明

· 作者信息等

代码注释向阅读者说明代码除了内在逻辑信息之外其余信息，包括辅助理解与说明编写者等内容。一个完善的代码开头总却少不了作者信息。
为了避免每次开始自己的代码时都要手动添加信息，这里通过查询了解到了一种方便设置：
在编译器（eclipse）窗口中依次window－>preference－>java－>codestyple－>codetemplate 当你选择到这部的时候就会看见右侧有一个框显示出code这个选项，你点开这个选项，点一下他下面的New Java files 然后你点edit按钮，把他的内容换成你的就可以了（下图以中文版说明流程）


替换内容可以按照自己的基本信息格式完成编写。

这里可以利用说明符“${}”支持相关的信息宏定义，当然，个人项目按照自己的习惯就好，但是，若自己的编写内容要在一个标准化环境下或者一个项目组中应用的话，还是以组内标准要求为主。

修改完成之后，试着创建今天的任务：

可以发现，系统已经自动帮你完成默认内容的生成。然后你只需要部分变动的信息即可。

· 函数头部注释技巧

关于函数注释的话，回到刚刚的首选项框体，只需修改刚刚“注释”选项下面的“方法”即可

这里注意修改方式，默认内容中的“${tags}”里面的内容是自动识别函数变量的内容，建议保留。

完成了之后，我们试着创建一个main函数，然后下面两种方式创建我们的注释：
第一种，在函数上方输入/**，然后回车即可快速生成注释

第二种是光标选中我们的函数名，然后快捷Shift+Alt+J 可快速生成

二、基本if语句 与 函数（方法）

· 基本if语法

今天使用的用来验证条件语句的案例是整型数据的绝对值计算，因为绝对值计算可以展开为简单的分段函数，符合if-else语句的使用环境。
基本if操作部分代码如下：

package basic;

/**
 * The usage of the if statement.
 * 
 * @author Xingyi Zhang 1328365276@qq.com
 */

public class IfStatement {

	/**
	 *********************
	 * The entrance of the program.
	 * 
	 * @param args Not used now.
	 *********************
	 */
	public static void main(String args[]) {
		int tempNumber1, tempNumber2;

		// Try a positive value
		tempNumber1 = 5;

		if (tempNumber1 >= 0) {
			tempNumber2 = tempNumber1;
		} else {
			tempNumber2 = -tempNumber1;
		} // Of if

		System.out.println("The absolute value of " + tempNumber1 + " is " + tempNumber2);

		// Try a negative value
		// Lines 36 through 42 are the same as Lines 24 thorough 30
		tempNumber1 = -3;

		if (tempNumber1 >= 0) {
			tempNumber2 = tempNumber1;
		} else {
			tempNumber2 = -tempNumber1;
		} // Of if

		System.out.println("The absolute value of " + tempNumber1 + " is " + tempNumber2);
	}// Of main
}// Of class IfStatement

运行结果如下图：

上述可见，if语句的使用是类似C与C++，C#等C系列语言的，并没有非常特别的差异

· 函数使用

函数使用案例中，承接上文构造了求绝对值的实现，构造函数（方法）abs()

package basic;

/**
 * The usage of the if statement.
 * 
 * @author Xingyi Zhang 1328365276@qq.com
 */

public class IfStatement {

	/**
	 *********************
	 * The entrance of the program.
	 * 
	 * @param args Not used now.
	 *********************
	 */
	public static void main(String args[]) {
		int tempNumber1, tempNumber2;

		// Now we use a method/function for this purpose.
		tempNumber1 = 6;
		System.out.println("The absolute value of " + tempNumber1 + " is " + abs(tempNumber1));
		tempNumber1 = -8;
		System.out.println("The absolute value of " + tempNumber1 + " is " + abs(tempNumber1));
	}// Of main

	/**
	 *********************
	 * The absolute value of the given parameter.
	 * 
	 * @param paraValue The given value.
	 * @return The absolute value of the paraValue.
	 *********************
	 */
	public static int abs(int paraValue) {
		if (paraValue >= 0) {
			return paraValue;
		} else {
			return -paraValue;
		} // Of if
	}// Of abs
}// Of class IfStatement

运行结果如下图

1.函数使用过程中，注意函数头部的关键字使用。这里对函数（方法）名加以“static”关键字，使得函数修饰为静态方法，这使得无需本类的对象即可调用此方法。一般来说，静态方法常常为应用程序中的其它类提供一些实用工具所用，在Java的类库中大量的静态方法正是出于此目的而定义的。此类方法，不需要创建对象。（参考自互联网）
2.其中“public”访问修饰符说明了方法的使用权限，这里可类比C++的类中方法的构造，是最低的限制权限，基本上是任何类，子类，包都可以访问。基本上来说，定义一个普通函数都是以public static作为基本的修饰。
（特别注意！public可以省略不写作为默认值，但是默认值的权限会相对比较高，具体见下图）

我从网上找的了不错的说明修饰顺序的图来参考：

总结

java基本的逻辑运算与条件运算承接他的C语言前辈（以及C语言一家人如C++，C#），基本上没有特别变化，多条件也是以if-else if-else的形式出现。
关于函数（方法）,按照下列构造准则即可：

修饰符 返回值类型 方法名(参数类型 参数名){
    ...
    方法体
    ...
    return 返回值;
}

最后要总结的一点就是要规范注释方案，这一点需要从每次编程中逐步养成习惯才行。