Java 简明教程

Java - Quick Guide

Java - Overview

Java 编程语言最初由 Sun Microsystems 开发,由 James Gosling 发起,并于 1995 年作为 Sun Microsystems 的 Java 平台(Java 1.0 [J2SE])的核心组件发布。

Java programming language was originally developed by Sun Microsystems which was initiated by James Gosling and released in 1995 as core component of Sun Microsystems' Java platform (Java 1.0 [J2SE]).

Java Standard Edition 最新版本是 Java SE 8。随着 Java 的进步及其广泛普及,构建了多种配置以适应各种类型的平台。例如:用于企业应用程序的 J2EE,用于移动应用程序的 J2ME。

The latest release of the Java Standard Edition is Java SE 8. With the advancement of Java and its widespread popularity, multiple configurations were built to suit various types of platforms. For example: J2EE for Enterprise Applications, J2ME for Mobile Applications.

新 J2 版本分别更名为 Java SE、Java EE 和 Java ME。Java 有保证 Write Once, Run Anywhere.

The new J2 versions were renamed as Java SE, Java EE, and Java ME respectively. Java is guaranteed to be Write Once, Run Anywhere.

Java 是 −

Java is −

  1. Object Oriented − In Java, everything is an Object. Java can be easily extended since it is based on the Object model.

  2. Platform Independent − Unlike many other programming languages including C and C++, when Java is compiled, it is not compiled into platform specific machine, rather into platform independent byte code. This byte code is distributed over the web and interpreted by the Virtual Machine (JVM) on whichever platform it is being run on.

  3. Simple − Java is designed to be easy to learn. If you understand the basic concept of OOP Java, it would be easy to master.

  4. Secure − With Java’s secure feature it enables to develop virus-free, tamper-free systems. Authentication techniques are based on public-key encryption.

  5. Architecture-neutral − Java compiler generates an architecture-neutral object file format, which makes the compiled code executable on many processors, with the presence of Java runtime system.

  6. Portable − Being architecture-neutral and having no implementation dependent aspects of the specification makes Java portable. Compiler in Java is written in ANSI C with a clean portability boundary, which is a POSIX subset.

  7. Robust − Java makes an effort to eliminate error prone situations by emphasizing mainly on compile time error checking and runtime checking.

  8. Multithreaded − With Java’s multithreaded feature it is possible to write programs that can perform many tasks simultaneously. This design feature allows the developers to construct interactive applications that can run smoothly.

  9. Interpreted − Java byte code is translated on the fly to native machine instructions and is not stored anywhere. The development process is more rapid and analytical since the linking is an incremental and light-weight process.

  10. High Performance − With the use of Just-In-Time compilers, Java enables high performance.

  11. Distributed − Java is designed for the distributed environment of the internet.

  12. Dynamic − Java is considered to be more dynamic than C or C++ since it is designed to adapt to an evolving environment. Java programs can carry extensive amount of run-time information that can be used to verify and resolve accesses to objects on run-time.

Hello World using Java Programming.

为了让你对 Java 编程产生一些兴趣,我将为你提供一个小型传统的 C 编程 Hello World 程序,你可以使用演示链接尝试一下。

Just to give you a little excitement about Java programming, I’m going to give you a small conventional C Programming Hello World program, You can try it using Demo link.

public class MyFirstJavaProgram {

   /* This is my first java program.
    * This will print 'Hello World' as the output
    */

   public static void main(String []args) {
      System.out.println("Hello World"); // prints Hello World
   }
}

History of Java

詹姆斯·高斯林在 1991 年 6 月发起了 Java 语言项目,用于在其众多的机顶盒项目之一中使用。这门语言最初被称为“Oak”,以高斯林办公室外的一棵橡树命名,也曾被称为“Green”,后来从一组随机单词中更名为 Java。

James Gosling initiated Java language project in June 1991 for use in one of his many set-top box projects. The language, initially called 'Oak' after an oak tree that stood outside Gosling’s office, also went by the name 'Green' and ended up later being renamed as Java, from a list of random words.

Sun 于 1995 年发布了第一个公共实施版本 Java 1.0。它承诺*Write Once, Run Anywhere*(WORA),提供了在流行平台上免费运行时。

Sun released the first public implementation as Java 1.0 in 1995. It promised Write Once, Run Anywhere (WORA), providing no-cost run-times on popular platforms.

2006 年 11 月 13 日,Sun 根据 GNU 通用公共许可证 (GPL) 的条款发布了大部分 Java 作为自由和开放源代码软件。

On 13 November, 2006, Sun released much of Java as free and open source software under the terms of the GNU General Public License (GPL).

2007 年 5 月 8 日,Sun 完成了该过程,使 Java 的所有核心代码成为自由和开源,除了 Sun 没有持有其版权的一小部分代码。

On 8 May, 2007, Sun finished the process, making all of Java’s core code free and open-source, aside from a small portion of code to which Sun did not hold the copyright.

Tools You Will Need

为了执行本教程中讨论的示例,你需要一台奔腾 200 兆赫计算机,最小内存为 64 MB(建议内存为 128 MB)。

For performing the examples discussed in this tutorial, you will need a Pentium 200-MHz computer with a minimum of 64 MB of RAM (128 MB of RAM recommended).

你还需要以下软件 −

You will also need the following softwares −

  1. Linux 7.1 or Windows xp/7/8 operating system

  2. Java JDK 8

  3. Microsoft Notepad or any other text editor

本教程将提供使用 Java 创建 GUI、网络和 Web 应用程序的必要技能。

This tutorial will provide the necessary skills to create GUI, networking, and web applications using Java.

What is Next?

下一章将指导你如何获取 Java 及其文档。最后,它将指导你如何安装 Java 并准备用于开发 Java 应用程序的环境。

The next chapter will guide you to how you can obtain Java and its documentation. Finally, it instructs you on how to install Java and prepare an environment to develop Java applications.

Java - Environment Setup

Live Demo Option Online

我们在线设置了 Java 编程环境,以便你可以在线编译和执行所有可用的示例。它让你对你所读的内容充满信心,并使你能够使用不同的选项验证程序。随意修改任何示例并在线执行。

We have set up the Java Programming environment online, so that you can compile and execute all the available examples online. It gives you confidence in what you are reading and enables you to verify the programs with different options. Feel free to modify any example and execute it online.

尝试使用如下示例代码框右上角提供的 Live Demo 选项执行以下示例 −

Try the following example using Live Demo option available at the top right corner of the below sample code box −

public class MyFirstJavaProgram {
   public static void main(String []args) {
      System.out.println("Hello World");
   }
}

对于本教程中给出的大多数示例,你将发现我们网站代码部分右上角有一个 Try it 选项,它将带你到在线编译器。所以,善加利用并享受你的学习吧。

For most of the examples given in this tutorial, you will find a Try it option in our website code sections at the top right corner that will take you to the online compiler. So just make use of it and enjoy your learning.

Local Environment Setup

如果你想为 Java 编程语言设置自己的环境,本节将指导你完成整个过程。请按照以下步骤来设置 Java 环境。

If you want to set up your own environment for Java programming language, then this section guides you through the whole process. Please follow the steps given below to set up your Java environment.

Java SE 可免费下载。若要下载 click here,请下载与你的操作系统兼容的版本。

Java SE is available for download for free. To download click here, please download a version compatible with your operating system.

按照说明下载 Java,并运行 .exe 在你的计算机上安装 Java。在计算机上安装 Java 后,你需要设置环境变量来指向正确的安装目录。

Follow the instructions to download Java, and run the .exe to install Java on your machine. Once you have installed Java on your machine, you would need to set environment variables to point to correct installation directories.

Setting Up the Path for Windows 2000/XP

假设你已将 Java 安装在 c:\Program Files\java\jdk 目录中 −

Assuming you have installed Java in c:\Program Files\java\jdk directory −

  1. Right-click on 'My Computer' and select 'Properties'.

  2. Click on the 'Environment variables' button under the 'Advanced' tab.

  3. Now, edit the 'Path' variable and add the path to the Java executable directory at the end of it. For example, if the path is currently set to C:\Windows\System32, then edit it the following way C:\Windows\System32;c:\Program Files\java\jdk\bin.

Setting Up the Path for Windows 95/98/ME

假设你已将 Java 安装在 c:\Program Files\java\jdk 目录中 −

Assuming you have installed Java in c:\Program Files\java\jdk directory −

  1. Edit the 'C:\autoexec.bat' file and add the following line at the end − SET PATH=%PATH%;C:\Program Files\java\jdk\bin

Setting Up the Path for Linux, UNIX, Solaris, FreeBSD

环境变量 PATH 应设置为指向已安装 Java 二进制文件的位置。如果你在这方面遇到问题,请参阅 shell 文档。

Environment variable PATH should be set to point to where the Java binaries have been installed. Refer to your shell documentation if you have trouble doing this.

例如,如果你使用 bash 作为你的 shell,那么你将在 .bashrc 的末尾添加以下行 −

For example, if you use bash as your shell, then you would add the following line at the end of your .bashrc

要编写 Java 程序,你需要一个文本编辑器。市场上还有功能更强大的 IDE。最受欢迎的简要介绍如下 −

To write Java programs, you need a text editor. There are even more sophisticated IDEs available in the market. The most popular ones are briefly described below −

  1. Notepad − On Windows machine, you can use any simple text editor like Notepad (recommended for this tutorial) or WordPad. Notepad++ is also a free text editor which enhanced facilities.

  2. Netbeans − It is a Java IDE that is open-source and free which can be downloaded from www.netbeans.org/index.html.

  3. Eclipse − It is also a Java IDE developed by the Eclipse open-source community and can be downloaded from www.eclipse.org.

IDE 或集成开发环境提供编程所需的所有常见工具和设施,如源代码编辑器、构建工具和调试器等。

IDE or Integrated Development Environment, provides all common tools and facilities to aid in programming, such as source code editor, build tools and debuggers etc.

What is Next?

下一章将教你如何编写和运行你的第一个 Java 程序以及开发应用程序所需的一些重要的 Java 基本语法。

Next chapter will teach you how to write and run your first Java program and some of the important basic syntaxes in Java needed for developing applications.

Java - Basic Syntax

当我们考虑 Java 程序时,可以将它定义为通过调用彼此的方法而相互通信的对象集合。现在,让我们简单了解一下类、对象、方法和实例变量的含义。

When we consider a Java program, it can be defined as a collection of objects that communicate via invoking each other’s methods. Let us now briefly look into what do class, object, methods, and instance variables mean.

  1. Object − Objects have states and behaviors. Example: A dog has states - color, name, breed as well as behavior such as wagging their tail, barking, eating. An object is an instance of a class.

  2. Class − A class can be defined as a template/blueprint that describes the behavior/state that the object of its type supports.

  3. Methods − A method is basically a behavior. A class can contain many methods. It is in methods where the logics are written, data is manipulated and all the actions are executed.

  4. Instance Variables − Each object has its unique set of instance variables. An object’s state is created by the values assigned to these instance variables.

First Java Program

让我们看一个简单的代码,它将打印单词 Hello World

Let us look at a simple code that will print the words Hello World.

Example

public class MyFirstJavaProgram {

   /* This is my first java program.
    * This will print 'Hello World' as the output
    */

   public static void main(String []args) {
      System.out.println("Hello World"); // prints Hello World
   }
}

让我们看看怎样来保存文件、编译和运行程序。请遵循以下步骤:

Let’s look at how to save the file, compile, and run the program. Please follow the subsequent steps −

  1. Open notepad and add the code as above.

  2. Save the file as: MyFirstJavaProgram.java.

  3. Open a command prompt window and go to the directory where you saved the class. Assume it’s C:\.

  4. Type 'javac MyFirstJavaProgram.java' and press enter to compile your code. If there are no errors in your code, the command prompt will take you to the next line (Assumption : The path variable is set).

  5. Now, type ' java MyFirstJavaProgram ' to run your program.

  6. You will be able to see ' Hello World ' printed on the window.

Output

C:\> javac MyFirstJavaProgram.java
C:\> java MyFirstJavaProgram
Hello World

Basic Syntax

关于 Java 程序,牢记以下几点非常重要。

About Java programs, it is very important to keep in mind the following points.

  1. Case Sensitivity − Java is case sensitive, which means identifier Hello and hello would have different meaning in Java.

  2. Class Names − For all class names the first letter should be in Upper Case. If several words are used to form a name of the class, each inner word’s first letter should be in Upper Case. Example: class MyFirstJavaClass

  3. Method Names − All method names should start with a Lower Case letter. If several words are used to form the name of the method, then each inner word’s first letter should be in Upper Case. Example: public void myMethodName()

  4. Program File Name − Name of the program file should exactly match the class name. When saving the file, you should save it using the class name (Remember Java is case sensitive) and append '.java' to the end of the name (if the file name and the class name do not match, your program will not compile). But please make a note that in case you do not have a public class present in the file then file name can be different than class name. It is also not mandatory to have a public class in the file. Example: Assume 'MyFirstJavaProgram' is the class name. Then the file should be saved as 'MyFirstJavaProgram.java'

  5. public static void main(String args[]) − Java program processing starts from the main() method which is a mandatory part of every Java program.

Java Identifiers

所有 Java 组件都需要名称。用于类、变量和方法的名称称为 identifiers

All Java components require names. Names used for classes, variables, and methods are called identifiers.

在 Java 中,关于标识符,有几个要点需要记住。它们如下所示:

In Java, there are several points to remember about identifiers. They are as follows −

  1. All identifiers should begin with a letter (A to Z or a to z), currency character ($) or an underscore (_).

  2. After the first character, identifiers can have any combination of characters.

  3. A key word cannot be used as an identifier.

  4. Most importantly, identifiers are case sensitive.

  5. Examples of legal identifiers: age, $salary, _value, __1_value.

  6. Examples of illegal identifiers: 123abc, -salary.

Java Modifiers

与其他语言一样,可以使用修饰符来修改类、方法等。有两类修饰符 -

Like other languages, it is possible to modify classes, methods, etc., by using modifiers. There are two categories of modifiers −

  1. Access Modifiers − default, public , protected, private

  2. Non-access Modifiers − final, abstract, strictfp

我们将在下一部分详细了解修饰符。

We will be looking into more details about modifiers in the next section.

Java Variables

以下是 Java 中的变量类型 -

Following are the types of variables in Java −

  1. Local Variables

  2. Class Variables (Static Variables)

  3. Instance Variables (Non-static Variables)

Java Arrays

数组是存储相同类型的多个变量的对象。但是,数组本身是堆上的对象。我们将在即将到来的章节中研究如何声明、构建和初始化。

Arrays are objects that store multiple variables of the same type. However, an array itself is an object on the heap. We will look into how to declare, construct, and initialize in the upcoming chapters.

Java Enums

枚举是在 Java 5.0 中引入的。枚举将变量限制为仅具有少数预定义值之一。此枚举列表中的值称为枚举。

Enums were introduced in Java 5.0. Enums restrict a variable to have one of only a few predefined values. The values in this enumerated list are called enums.

使用枚举可以减少代码中的错误数量。

With the use of enums it is possible to reduce the number of bugs in your code.

例如,如果我们考虑一个鲜榨果汁店的应用程序,那么可以将玻璃杯的大小限制为小号、中号和大号。这将确保其他人无法订购除小号、中号或大号之外的任何尺寸。

For example, if we consider an application for a fresh juice shop, it would be possible to restrict the glass size to small, medium, and large. This would make sure that it would not allow anyone to order any size other than small, medium, or large.

Example

class FreshJuice {
   enum FreshJuiceSize{ SMALL, MEDIUM, LARGE }
   FreshJuiceSize size;
}

public class FreshJuiceTest {

   public static void main(String args[]) {
      FreshJuice juice = new FreshJuice();
      juice.size = FreshJuice.FreshJuiceSize.MEDIUM ;
      System.out.println("Size: " + juice.size);
   }
}

Output

Size: MEDIUM

Note - 枚举可以自己声明,也可以在类内声明。方法、变量、构造函数也可以在枚举中定义。

Note − Enums can be declared as their own or inside a class. Methods, variables, constructors can be defined inside enums as well.

Java Keywords

以下列表显示了 Java 中的保留字。这些保留字不能用作常量、变量或任何其他标识符名称。

The following list shows the reserved words in Java. These reserved words may not be used as constant or variable or any other identifier names.

Sr.No

Reserved Words & Description

1

abstractAs per dictionary, abstraction is the quality of dealing with ideas rather than events.

2

assertassert keyword is used in Java to define assertion. An assertion is a statement in Java which ensures the correctness of any assumptions which have been done in the program.

3

booleanboolean datatype is one of the eight primitive datatype supported by Java. It provides means to create boolean type variables which can accept a boolean value as true or false.

4

breakThe break statement in Java programming language has the following two usages − When the break statement is encountered inside a loop, the loop is immediately terminated and the program control resumes at the next statement following the loop. It can be used to terminate a case in the switch statement.

5

bytebyte datatype is one of the eight primitive datatype supported by Java. It provides means to create byte type variables which can accept a byte value.

6

casecase keyword is part of switch statement which allows a variable to be tested for equality against a list of values.

7

catchAn exception (or exceptional event) is a problem that arises during the execution of a program.

8

charchar datatype is one of the eight primitive datatype supported by Java.

9

classJava is an Object-Oriented Language. As a language that has the Object-Oriented feature.

10

constfinal keyword is used to define constant value or final methods/classes in Java.

11

continueThe continue keyword can be used in any of the loop control structures.

12

defaultdefault keyword is part of switch statement which allows a variable to be tested for equality against a list of values.

13

doA do…​while loop is similar to a while loop, except that a do…​while loop is guaranteed to execute at least one time.

14

doubledouble datatype is one of the eight primitive datatype supported by Java.

15

ifAn if statement can be followed by an optional else statement, which executes when the Boolean expression is false.

16

enumThe Java Enum class is the common base class of all Java language enumeration types.

17

extendsextends is the keyword used to inherit the properties of a class. Following is the syntax of extends keyword.

18

finalfinal keyword is used to define constant value or final methods/classes in Java.

19

finallyfinally keyword is used to define a finally block. The finally block follows a try block or a catch block. A finally block of code always executes, irrespective of occurrence of an Exception.

20

floatfloat datatype is one of the eight primitive datatype supported by Java. It provides means to create float type variables which can accept a float value.

21

forA for loop is a repetition control structure that allows you to efficiently write a loop that needs to be executed a specific number of times.

22

gotogoto statement is not supported by Java currrenly. It is kept as a reserved keyword for future. As an alternative, Java supports labels with break and continue statement.

23

ifAn if statement consists of a Boolean expression followed by one or more statements.

24

implementsGenerally, the implements keyword is used with classes to inherit the properties of an interface.

25

importimport keyboard is used in context of packages.

26

instanceofinstanceof keyword is an operator which is used only for object reference variables.

27

intint datatype is one of the eight primitive datatype supported by Java.

28

interfaceAn interface is a reference type in Java. It is similar to class. It is a collection of abstract methods.

29

longlong datatype is one of the eight primitive datatype supported by Java.

30

packagePackages are used in Java in order to prevent naming conflicts, to control access, to make searching/locating and usage of classes, interfaces, enumerations and annotations easier, etc.

31

privateMethods, variables, and constructors that are declared private can only be accessed within the declared class itself.

32

protectedThe protected access modifier cannot be applied to class and interfaces.

33

publicA class, method, constructor, interface, etc. declared public can be accessed from any other class.

34

shortBy assigning different data types to variables, you can store integers, decimals, or characters in these variables.

35

staticThe static keyword is used to create variables that will exist independently of any instances created for the class.

36

superThe super keyword is similar to this keyword.

37

switchA switch statement allows a variable to be tested for equality against a list of values.

38

thisthis keyword is a very important keyword to identify an object. Following are the usage of this keyword.

39

throwIf a method does not handle a checked exception, the method must declare it using the throws keyword.

40

transientSerialization is a concept using which we can write the state of an object into a byte stream so that we can transfer it over the network (using technologies like JPA and RMI).

41

tryA method catches an exception using a combination of the try and catch keywords.

42

whileA while loop statement in Java programming language repeatedly executes a target statement as long as a given condition is true.

Comments in Java

Java 使用非常类似于 C 和 C++ 的单行和多行注释。Java 编译器忽略任何注释中可用的所有字符。

Java supports single-line and multi-line comments very similar to C and C++. All characters available inside any comment are ignored by Java compiler.

Example

public class MyFirstJavaProgram {

   /* This is my first java program.
    * This will print 'Hello World' as the output
    * This is an example of multi-line comments.
    */

   public static void main(String []args) {
      // This is an example of single line comment
      /* This is also an example of single line comment. */
      System.out.println("Hello World");
   }
}

Output

Hello World

Using Blank Lines

仅包含空白字符(可能带有注释)的行称为空白行,Java 会完全忽略它。

A line containing only white space, possibly with a comment, is known as a blank line, and Java totally ignores it.

Inheritance

在 Java 中,类可从类派生。基本上,如果需要创建一个新类,并且此处已有的类包含一些所需的代码,那么可以从已有的代码派生新类。

In Java, classes can be derived from classes. Basically, if you need to create a new class and here is already a class that has some of the code you require, then it is possible to derive your new class from the already existing code.

此概念使你可以重复使用现有类的字段和方法,而无需在新建的类中重写代码。在这种情况下,现有类称为 superclass ,派生类称为 subclass

This concept allows you to reuse the fields and methods of the existing class without having to rewrite the code in a new class. In this scenario, the existing class is called the superclass and the derived class is called the subclass.

Interfaces

在 Java 语言中,接口可定义为对象之间如何进行通信的契约。在继承概念中,接口起着至关重要的作用。

In Java language, an interface can be defined as a contract between objects on how to communicate with each other. Interfaces play a vital role when it comes to the concept of inheritance.

接口定义派生类(子类)应使用的方法。但方法的实现完全取决于子类。

An interface defines the methods, a deriving class (subclass) should use. But the implementation of the methods is totally up to the subclass.

What is Next?

下一部分解释 Java 编程中的对象和类。在本部分结束时,你将清楚 Java 中的对象和类是什么。

The next section explains about Objects and classes in Java programming. At the end of the session, you will be able to get a clear picture as to what are objects and what are classes in Java.

Java - Variable Types

变量为我们的程序提供命名存储,以便其进行操作。Java 中的每个变量都有一个特定的类型,它决定了变量内存的大小和布局;可以在该内存中存储的值的范围;以及可以应用于该变量的操作集。

A variable provides us with named storage that our programs can manipulate. Each variable in Java has a specific type, which determines the size and layout of the variable’s memory; the range of values that can be stored within that memory; and the set of operations that can be applied to the variable.

在你使用所有变量之前,都必须声明它们。以下是变量声明的基本形式 −

You must declare all variables before they can be used. Following is the basic form of a variable declaration −

data type variable [ = value][, variable [ = value] ...] ;

此处数据类型是 Java 的数据类型之一,变量是变量的名称。若要声明指定类型的多个变量,可以使用逗号分隔列表。

Here data type is one of Java’s datatypes and variable is the name of the variable. To declare more than one variable of the specified type, you can use a comma-separated list.

以下是在 Java 中变量声明和初始化的有效示例 −

Following are valid examples of variable declaration and initialization in Java −

Example

int a, b, c;         // Declares three ints, a, b, and c.
int a = 10, b = 10;  // Example of initialization
byte B = 22;         // initializes a byte type variable B.
double pi = 3.14159; // declares and assigns a value of PI.
char a = 'a';        // the char variable a iis initialized with value 'a'

本章将解释 Java 语言提供的多种变量类型。Java 中有三种变量 −

This chapter will explain various variable types available in Java Language. There are three kinds of variables in Java −

  1. Local variables

  2. Instance variables

  3. Class/Static variables

Local Variables

  1. Local variables are declared in methods, constructors, or blocks.

  2. Local variables are created when the method, constructor or block is entered and the variable will be destroyed once it exits the method, constructor, or block.

  3. Access modifiers cannot be used for local variables.

  4. Local variables are visible only within the declared method, constructor, or block.

  5. Local variables are implemented at stack level internally.

  6. There is no default value for local variables, so local variables should be declared and an initial value should be assigned before the first use.

Example

这里,age 是一个局部变量。它在 pupAge() 方法中定义,并且其范围仅限于此方法。

Here, age is a local variable. This is defined inside pupAge() method and its scope is limited to only this method.

public class Test {
   public void pupAge() {
      int age = 0;
      age = age + 7;
      System.out.println("Puppy age is : " + age);
   }

   public static void main(String args[]) {
      Test test = new Test();
      test.pupAge();
   }
}

Output

Puppy age is: 7

Example

以下示例在未初始化的情况下使用了 age,因此它将在编译时给出错误。

Following example uses age without initializing it, so it would give an error at the time of compilation.

public class Test {
   public void pupAge() {
      int age;
      age = age + 7;
      System.out.println("Puppy age is : " + age);
   }

   public static void main(String args[]) {
      Test test = new Test();
      test.pupAge();
   }
}

Output

Test.java:4:variable number might not have been initialized
age = age + 7;
         ^
1 error

Instance Variables

  1. Instance variables are declared in a class, but outside a method, constructor or any block.

  2. When a space is allocated for an object in the heap, a slot for each instance variable value is created.

  3. Instance variables are created when an object is created with the use of the keyword 'new' and destroyed when the object is destroyed.

  4. Instance variables hold values that must be referenced by more than one method, constructor or block, or essential parts of an object’s state that must be present throughout the class.

  5. Instance variables can be declared in class level before or after use.

  6. Access modifiers can be given for instance variables.

  7. The instance variables are visible for all methods, constructors and block in the class. Normally, it is recommended to make these variables private (access level). However, visibility for subclasses can be given for these variables with the use of access modifiers.

  8. Instance variables have default values. For numbers, the default value is 0, for Booleans it is false, and for object references it is null. Values can be assigned during the declaration or within the constructor.

  9. Instance variables can be accessed directly by calling the variable name inside the class. However, within static methods (when instance variables are given accessibility), they should be called using the fully qualified name. ObjectReference.VariableName.

Example

import java.io.*;

public class Employee {

   // this instance variable is visible for any child class.
   public String name;

   // salary  variable is visible in Employee class only.
   private double salary;

   // The name variable is assigned in the constructor.
   public Employee (String empName) {
      name = empName;
   }

   // The salary variable is assigned a value.
   public void setSalary(double empSal) {
      salary = empSal;
   }

   // This method prints the employee details.
   public void printEmp() {
      System.out.println("name  : " + name );
      System.out.println("salary :" + salary);
   }

   public static void main(String args[]) {
      Employee empOne = new Employee("Ransika");
      empOne.setSalary(1000);
      empOne.printEmp();
   }
}

Output

name  : Ransika
salary :1000.0

Class/Static Variables

  1. Class variables also known as static variables are declared with the static keyword in a class, but outside a method, constructor or a block.

  2. There would only be one copy of each class variable per class, regardless of how many objects are created from it.

  3. Static variables are rarely used other than being declared as constants. Constants are variables that are declared as public/private, final, and static. Constant variables never change from their initial value.

  4. Static variables are stored in the static memory. It is rare to use static variables other than declared final and used as either public or private constants.

  5. Static variables are created when the program starts and destroyed when the program stops.

  6. Visibility is similar to instance variables. However, most static variables are declared public since they must be available for users of the class.

  7. Default values are same as instance variables. For numbers, the default value is 0; for Booleans, it is false; and for object references, it is null. Values can be assigned during the declaration or within the constructor. Additionally, values can be assigned in special static initializer blocks.

  8. Static variables can be accessed by calling with the class name ClassName.VariableName.

  9. When declaring class variables as public static final, then variable names (constants) are all in upper case. If the static variables are not public and final, the naming syntax is the same as instance and local variables.

Example

import java.io.*;

public class Employee {

   // salary  variable is a private static variable
   private static double salary;

   // DEPARTMENT is a constant
   public static final String DEPARTMENT = "Development ";

   public static void main(String args[]) {
      salary = 1000;
      System.out.println(DEPARTMENT + "average salary:" + salary);
   }
}

Output

Development average salary:1000

Note − 如果变量是从外部类访问的,则常量应作为 Employee.DEPARTMENT 访问

Note − If the variables are accessed from an outside class, the constant should be accessed as Employee.DEPARTMENT

What is Next?

您已经在本章中使用过访问修饰符(public 和 private)。下一章将详细说明访问修饰符和非访问修饰符。

You already have used access modifiers (public & private) in this chapter. The next chapter will explain Access Modifiers and Non-Access Modifiers in detail.

Java - Basic Datatypes

变量无非就是保留的内存位置,用于存储值。这意味着创建变量时,你将在内存中保留一些空间。

Variables are nothing but reserved memory locations to store values. This means that when you create a variable you reserve some space in the memory.

根据变量的数据类型,操作系统将分配内存,并决定在保留的内存中存储什么。因此,通过将不同的数据类型分配给变量,你可以在这些变量中存储整数、小数或字符。

Based on the data type of a variable, the operating system allocates memory and decides what can be stored in the reserved memory. Therefore, by assigning different data types to variables, you can store integers, decimals, or characters in these variables.

Java 中有两种数据类型 −

There are two data types available in Java −

  1. Primitive Data Types

  2. Reference/Object Data Types

Primitive Data Types

Java 支持八种基本数据类型。基本数据类型由语言预定义,并由关键字命名。下面我们详细介绍八种基本数据类型。

There are eight primitive datatypes supported by Java. Primitive datatypes are predefined by the language and named by a keyword. Let us now look into the eight primitive data types in detail.

byte

  1. Byte data type is an 8-bit signed two’s complement integer

  2. Minimum value is -128 (-2^7)

  3. Maximum value is 127 (inclusive)(2^7 -1)

  4. Default value is 0

  5. Byte data type is used to save space in large arrays, mainly in place of integers, since a byte is four times smaller than an integer.

  6. Example − byte a = 100, byte b = -50

short

  1. Short data type is a 16-bit signed two’s complement integer

  2. Minimum value is -32,768 (-2^15)

  3. Maximum value is 32,767 (inclusive) (2^15 -1)

  4. Short data type can also be used to save memory as byte data type. A short is 2 times smaller than an integer

  5. Default value is 0.

  6. Example − short s = 10000, short r = -20000

int

  1. Int data type is a 32-bit signed two’s complement integer.

  2. Minimum value is - 2,147,483,648 (-2^31)

  3. Maximum value is 2,147,483,647(inclusive) (2^31 -1)

  4. Integer is generally used as the default data type for integral values unless there is a concern about memory.

  5. The default value is 0

  6. Example − int a = 100000, int b = -200000

long

  1. Long data type is a 64-bit signed two’s complement integer

  2. Minimum value is -9,223,372,036,854,775,808(-2^63)

  3. Maximum value is 9,223,372,036,854,775,807 (inclusive)(2^63 -1)

  4. This type is used when a wider range than int is needed

  5. Default value is 0L

  6. Example − long a = 100000L, long b = -200000L

float

  1. Float data type is a single-precision 32-bit IEEE 754 floating point

  2. Float is mainly used to save memory in large arrays of floating point numbers

  3. Default value is 0.0f

  4. Float data type is never used for precise values such as currency

  5. Example − float f1 = 234.5f

double

  1. double data type is a double-precision 64-bit IEEE 754 floating point

  2. This data type is generally used as the default data type for decimal values, generally the default choice

  3. Double data type should never be used for precise values such as currency

  4. Default value is 0.0d

  5. Example − double d1 = 123.4

boolean

  1. boolean data type represents one bit of information

  2. There are only two possible values: true and false

  3. This data type is used for simple flags that track true/false conditions

  4. Default value is false

  5. Example − boolean one = true

char

  1. char data type is a single 16-bit Unicode character

  2. Minimum value is '\u0000' (or 0)

  3. Maximum value is '\uffff' (or 65,535 inclusive)

  4. Char data type is used to store any character

  5. Example − char letterA = 'A'

Example

以下示例展示了上面讨论的各种原始数据类型的用法。我们在数字数据类型上使用了 add 运算,而布尔变量和 char 变量则按原样打印。

Following examples shows the usage of variour primitive data types we’ve discussed above. We’ve used add operations on numeric data types whereas boolean and char variables are printed as such.

public class JavaTester {
   public static void main(String args[]) {

      byte byteValue1 = 2;
      byte byteValue2 = 4;
      byte byteResult = (byte)(byteValue1 + byteValue2);

      System.out.println("Byte: " + byteResult);

      short shortValue1 = 2;
      short shortValue2 = 4;
      short shortResult = (short)(shortValue1 + shortValue2);

      System.out.println("Short: " + shortResult);

      int intValue1 = 2;
      int intValue2 = 4;
      int intResult = intValue1 + intValue2;

      System.out.println("Int: " + intResult);

      long longValue1 = 2L;
      long longValue2 = 4L;
      long longResult = longValue1 + longValue2;

      System.out.println("Long: " + longResult);

      float floatValue1 = 2.0f;
      float floatValue2 = 4.0f;
      float floatResult = floatValue1 + floatValue2;

      System.out.println("Float: " + floatResult);

      double doubleValue1 = 2.0;
      double doubleValue2 = 4.0;
      double doubleResult = doubleValue1 + doubleValue2;

      System.out.println("Double: " + doubleResult);

      boolean booleanValue = true;

      System.out.println("Boolean: " + booleanValue);

      char charValue = 'A';

      System.out.println("Char: " + charValue);
   }
}

Output

Byte: 6
Short: 6
Int: 6
Long: 6
Float: 6.0
Double: 6.0
Boolean: true
Char: A

Reference Datatypes

  1. Reference variables are created using defined constructors of the classes. They are used to access objects. These variables are declared to be of a specific type that cannot be changed. For example, Employee, Puppy, etc.

  2. Class objects and various type of array variables come under reference datatype.

  3. Default value of any reference variable is null.

  4. A reference variable can be used to refer any object of the declared type or any compatible type.

  5. Example: Animal animal = new Animal("giraffe");

Java Literals

字面值是固定值的源代码表示形式。它们在代码中直接表示,无需任何计算。

A literal is a source code representation of a fixed value. They are represented directly in the code without any computation.

字面值可分配给任何原始类型变量。例如:

Literals can be assigned to any primitive type variable. For example −

byte a = 68;
char a = 'A';

byte、int、long 和 short 也可用十进制(基数 10)、十六进制(基数 16)或八进制(基数 8)数字系统来表示。

byte, int, long, and short can be expressed in decimal(base 10), hexadecimal(base 16) or octal(base 8) number systems as well.

使用这些数字系统表示字面值时,前缀 0 用于表示八进制,前缀 0x 用于表示十六进制。例如:

Prefix 0 is used to indicate octal, and prefix 0x indicates hexadecimal when using these number systems for literals. For example −

int decimal = 100;
int octal = 0144;
int hexa =  0x64;

Java 中的字符串字面值按照它们在大多数其他语言中的指定方式,即用一对双引号来括起一系列字符。字符串字面值示例如下:

String literals in Java are specified like they are in most other languages by enclosing a sequence of characters between a pair of double quotes. Examples of string literals are −

Example

"Hello World"
"two\nlines"
"\"This is in quotes\""

String 和 char 类型的字面值可以包含任何 Unicode 字符。例如:

String and char types of literals can contain any Unicode characters. For example −

char a = '\u0001';
String a = "\u0001";

Example

以下示例展示了上面讨论的各种字面值用法。

Following example shows the usage of variour literals we’ve discussed above.

public class JavaTester {
   public static void main(String args[]) {

      int decimal = 100;
      int octal = 0144;
      int hexa =  0x64;

      System.out.println(decimal);
      System.out.println(octal);
      System.out.println(hexa);

      String msg1 = "Hello World";
      String msg2 = "two\nlines";
      String msg3 = "\"This is in quotes\"";

      System.out.println(msg1);
      System.out.println(msg2);
      System.out.println(msg3);

      char a = '\u0064';
      String msg4 = "\u0064";

      System.out.println(a);
      System.out.println(msg4);
   }
}

Output

100
100
100
Hello World
two
lines
"This is in quotes"
d
d

Java 语言还支持用于 String 和 char 字面值的一些特殊转义序列。它们包括:

Java language supports few special escape sequences for String and char literals as well. They are −

Notation

Character represented

\n

Newline (0x0a)

\r

Carriage return (0x0d)

\f

Formfeed (0x0c)

\b

Backspace (0x08)

\s

Space (0x20)

\t

tab

\"

Double quote

\'

Single quote

|backslash

\ddd

Octal character (ddd)

\uxxxx

What is Next?

本章解释了各种数据类型。下一个主题解释了不同的变量类型及其用法。这将使你很好地了解如何在 Java 类、接口等中使用它们。

This chapter explained the various data types. The next topic explains different variable types and their usage. This will give you a good understanding on how they can be used in the Java classes, interfaces, etc.

Java - Basic Operators

Java 提供了一组丰富的操作符用于操作变量。我们可以将所有 Java 操作符划分为以下组:

Java provides a rich set of operators to manipulate variables. We can divide all the Java operators into the following groups −

  1. Arithmetic Operators

  2. Relational Operators

  3. Bitwise Operators

  4. Logical Operators

  5. Assignment Operators

  6. Misc Operators

The Arithmetic Operators

算术运算符在数学表达式中使用的方式与其在代数中的使用方式相同。下表列出了算术运算符 −

Arithmetic operators are used in mathematical expressions in the same way that they are used in algebra. The following table lists the arithmetic operators −

假设整型变量 A 为 10,变量 B 为 20,那么 −

Assume integer variable A holds 10 and variable B holds 20, then −

Operator

Description

Example

+ (Addition)

Adds values on either side of the operator.

A + B will give 30

- (Subtraction)

Subtracts right-hand operand from left-hand operand.

A - B will give -10

* (Multiplication)

Multiplies values on either side of the operator.

A * B will give 200

/ (Division)

Divides left-hand operand by right-hand operand.

B / A will give 2

% (Modulus)

Divides left-hand operand by right-hand operand and returns remainder.

B % A will give 0

++ (Increment)

Increases the value of operand by 1.

B++ gives 21

 — (Decrement)

Decreases the value of operand by 1.

B-- gives 19

The Relational Operators

Java 语言支持以下关系运算符。

There are following relational operators supported by Java language.

假设变量 A 为 10,变量 B 为 20,那么 −

Assume variable A holds 10 and variable B holds 20, then −

Operator

Description

Example

== (equal to)

Checks if the values of two operands are equal or not, if yes then condition becomes true.

(A == B) is not true.

!= (not equal to)

Checks if the values of two operands are equal or not, if values are not equal then condition becomes true.

(A != B) is true.

> (greater than)

Checks if the value of left operand is greater than the value of right operand, if yes then condition becomes true.

(A > B) is not true.

< (less than)

Checks if the value of left operand is less than the value of right operand, if yes then condition becomes true.

(A < B) is true.

>= (greater than or equal to)

Checks if the value of left operand is greater than or equal to the value of right operand, if yes then condition becomes true.

(A >= B) is not true.

⇐ (less than or equal to)

Checks if the value of left operand is less than or equal to the value of right operand, if yes then condition becomes true.

(A ⇐ B) is true.

The Bitwise Operators

Java 定义了多个按位运算符,它们可以应用于整数类型 long、int、short、char 和 byte。

Java defines several bitwise operators, which can be applied to the integer types, long, int, short, char, and byte.

按位运算符对二进制位进行运算,并执行按位运算。假设 a = 60 且 b = 13;现在以二进制格式,它们如下所示:

Bitwise operator works on bits and performs bit-by-bit operation. Assume if a = 60 and b = 13; now in binary format they will be as follows −

a = 0011 1100
b = 0000 1101
a&b = 0000 1100
a|b = 0011 1101
a^b = 0011 0001
~a  = 1100 0011

下表列出了按位运算符:

The following table lists the bitwise operators −

假设整数变量 A 保存 60 且变量 B 保存 13,则:

Assume integer variable A holds 60 and variable B holds 13 then −

Operator

Description

Example

& (bitwise and)

Binary AND Operator copies a bit to the result if it exists in both operands.

(A & B) will give 12 which is 0000 1100

(bitwise or)

Binary OR Operator copies a bit if it exists in either operand.

(A

B) will give 61 which is 0011 1101

^ (bitwise XOR)

Binary XOR Operator copies the bit if it is set in one operand but not both.

(A ^ B) will give 49 which is 0011 0001

⁓ (bitwise compliment)

Binary Ones Complement Operator is unary and has the effect of 'flipping' bits.

(⁓A ) will give -61 which is 1100 0011 in 2’s complement form due to a signed binary number.

<< (left shift)

Binary Left Shift Operator. The left operands value is moved left by the number of bits specified by the right operand.

A << 2 will give 240 which is 1111 0000

>> (right shift)

Binary Right Shift Operator. The left operands value is moved right by the number of bits specified by the right operand.

A >> 2 will give 15 which is 1111

>>> (zero fill right shift)

The Logical Operators

下表列出了逻辑运算符:

The following table lists the logical operators −

假设布尔变量 A 为 true,变量 B 为 false,则:

Assume Boolean variables A holds true and variable B holds false, then −

Operator

Description

Example

&& (logical and)

Called Logical AND operator. If both the operands are non-zero, then the condition becomes true.

(A && B) is false

(logical or)

Called Logical OR Operator. If any of the two operands are non-zero, then the condition becomes true.

(A

B) is true

! (logical not)

Called Logical NOT Operator. Use to reverses the logical state of its operand. If a condition is true then Logical NOT operator will make false.

The Assignment Operators

以下是 Java 语言支持的赋值运算符 −

Following are the assignment operators supported by Java language −

Operator

Description

Example

=

Simple assignment operator. Assigns values from right side operands to left side operand.

C = A + B will assign value of A + B into C

+=

Add AND assignment operator. It adds right operand to the left operand and assign the result to left operand.

C += A is equivalent to C = C + A

-=

Subtract AND assignment operator. It subtracts right operand from the left operand and assign the result to left operand.

C -= A is equivalent to C = C - A

*=

Multiply AND assignment operator. It multiplies right operand with the left operand and assign the result to left operand.

C *= A is equivalent to C = C * A

/=

Divide AND assignment operator. It divides left operand with the right operand and assign the result to left operand.

C /= A is equivalent to C = C / A

%=

Modulus AND assignment operator. It takes modulus using two operands and assign the result to left operand.

C %= A is equivalent to C = C % A

<⇐

Left shift AND assignment operator.

C <⇐ 2 is same as C = C << 2

>>=

Right shift AND assignment operator.

C >>= 2 is same as C = C >> 2

&=

Bitwise AND assignment operator.

C &= 2 is same as C = C & 2

^=

bitwise exclusive OR and assignment operator.

C ^= 2 is same as C = C ^ 2

=

bitwise inclusive OR and assignment operator.

C

= 2 is same as C = C

2

Miscellaneous Operators

Java 语言支持的其他几个运算符。

There are few other operators supported by Java Language.

Conditional Operator ( ? : )

条件运算符又称为 ternary operator。该运算符由三个操作数组成,用于评估布尔表达式。该运算符的目标是决定应将哪个值分配给变量。该运算符写为 −

Conditional operator is also known as the ternary operator. This operator consists of three operands and is used to evaluate Boolean expressions. The goal of the operator is to decide, which value should be assigned to the variable. The operator is written as −

variable x = (expression) ? value if true : value if false

以下是示例 −

Following is an example −

Example

在这个示例中,我们创建了两个变量 a 和 b,并且使用 ternary operator 决定了 b 的值并打印出来了。

In this example, we’re creating two variables a and b and using ternary operator we’ve decided the values of b and printed it.

public class Test {

   public static void main(String args[]) {
      int a, b;
      a = 10;
      b = (a == 1) ? 20: 30;
      System.out.println( "Value of b is : " +  b );

      b = (a == 10) ? 20: 30;
      System.out.println( "Value of b is : " + b );
   }
}

Output

Value of b is : 30
Value of b is : 20

instanceof Operator

该运算符仅用于对象引用变量。该运算符检查对象是否为特定类型(类类型或接口类型)。instanceof 运算符写为 −

This operator is used only for object reference variables. The operator checks whether the object is of a particular type (class type or interface type). instanceof operator is written as −

( Object reference variable ) instanceof  (class/interface type)

如果运算符左侧变量引用的对象通过了右侧类/接口类型的 IS-A 检查,则结果将为 true。以下是示例 −

If the object referred by the variable on the left side of the operator passes the IS-A check for the class/interface type on the right side, then the result will be true. Following is an example −

Example

在此示例中,我们创建了一个 String 变量 name,然后使用 instanceof operator 检查 name 是否为 String。

In this example, we’re creating a String variable name and then using instanceof operator we’ve checking the name is of String or not.

public class Test {

   public static void main(String args[]) {

      String name = "James";

      // following will return true since name is type of String
      boolean result = name instanceof String;
      System.out.println( result );
   }
}

Output

true

如果要比较的对象与右侧的类型兼容,则此运算符仍将返回 true。以下是一个示例 −

This operator will still return true, if the object being compared is the assignment compatible with the type on the right. Following is one more example −

Example

在此示例中,我们创建一个类的变量 a Vehicle,然后使用 instanceof operator 检查 name 是否为类型 Car。

In this example, we’re creating a variable a of class Vehicle and then using instanceof operator we’ve checking the name is of type Car or not.

class Vehicle {}

public class Car extends Vehicle {

   public static void main(String args[]) {

      Vehicle a = new Car();
      boolean result =  a instanceof Car;
      System.out.println( result );
   }
}

Output

true

Precedence of Java Operators

运算符优先级决定表达式中术语的分组。这会影响表达式的评估方式。某些运算符的优先级高于其他运算符;例如,乘法运算符的优先级高于加法运算符 −

Operator precedence determines the grouping of terms in an expression. This affects how an expression is evaluated. Certain operators have higher precedence than others; for example, the multiplication operator has higher precedence than the addition operator −

例如,x = 7 + 3 * 2;此处 x 分配为 13,而不是 20,因为运算符 * 的优先级高于 +,因此它首先与 3 * 2 相乘,然后加到 7 中。

For example, x = 7 + 3 * 2; here x is assigned 13, not 20 because operator * has higher precedence than +, so it first gets multiplied with 3 * 2 and then adds into 7.

此处,优先级最高的运算符显示在表顶部,优先级最低的运算符显示在表底部。在表达式中,将首先评估优先级较高的运算符。

Here, operators with the highest precedence appear at the top of the table, those with the lowest appear at the bottom. Within an expression, higher precedence operators will be evaluated first.

Category

Operator

Associativity

Postfix

expression++ expression--

Left to right

Unary

++expression --expression +expression -expression ⁓ !

Right to left

Multiplicative

* / %

Left to right

Additive

+ -

Left to right

Shift

<< >> >>>

Left to right

Relational

< > ⇐ >= instanceof

Left to right

Equality

== !=

Left to right

Bitwise AND

&

Left to right

Bitwise XOR

^

Left to right

Bitwise OR

Left to right

Logical AND

&&

Left to right

Logical OR

Left to right

Conditional

?:

Right to left

Assignment

= += -= *= /= %= ^=

= <⇐ >>= >>>=

What is Next?

下一章将介绍 Java 编程中的循环控制。该章节将描述各种类型的循环,以及如何在 Java 程序开发中使用这些循环及其用途。

The next chapter will explain about loop control in Java programming. The chapter will describe various types of loops and how these loops can be used in Java program development and for what purposes they are being used.

Java - Loop Control

您可能需要执行一段代码块多次。通常,语句按顺序执行:函数中的第一个语句先执行,然后是第二个,依此类推。

There may be a situation when you need to execute a block of code several number of times. In general, statements are executed sequentially: The first statement in a function is executed first, followed by the second, and so on.

编程语言提供了各种控制结构,允许执行更复杂的路径。

Programming languages provide various control structures that allow for more complicated execution paths.

loop 语句允许我们执行一个语句或语句组多次,以下是大多数编程语言中循环语句的一般形式 −

A loop statement allows us to execute a statement or group of statements multiple times and following is the general form of a loop statement in most of the programming languages −

loop architecture

Java 编程语言提供以下类型的循环来处理循环要求。单击以下链接查看其详细信息。

Java programming language provides the following types of loop to handle looping requirements. Click the following links to check their detail.

Sr.No.

Loop & Description

1

while loopRepeats a statement or group of statements while a given condition is true. It tests the condition before executing the loop body.

2

for loopExecute a sequence of statements multiple times and abbreviates the code that manages the loop variable.

3

do…​while loopLike a while statement, except that it tests the condition at the end of the loop body.

Loop Control Statements

循环控制语句改变了它在正常序列中的执行。当执行退出一个作用域时,在该作用域中创建的所有自动对象会被销毁。

Loop control statements change execution from its normal sequence. When execution leaves a scope, all automatic objects that were created in that scope are destroyed.

Java 支持以下控制语句。单击以下链接查看其详细信息。

Java supports the following control statements. Click the following links to check their detail.

Sr.No.

Control Statement & Description

1

break statementTerminates the loop or switch statement and transfers execution to the statement immediately following the loop or switch.

2

continue statementCauses the loop to skip the remainder of its body and immediately retest its condition prior to reiterating.

Enhanced for loop in Java

Java 5 引入了增强型 for 循环。这主要用于遍历包含数组在内的元素集合。

As of Java 5, the enhanced for loop was introduced. This is mainly used to traverse collection of elements including arrays.

Syntax

以下是增强型 for 循环的语法:

Following is the syntax of enhanced for loop −

for(declaration : expression) {
   // Statements
}
  1. Declaration − The newly declared block variable, is of a type compatible with the elements of the array you are accessing. The variable will be available within the for block and its value would be the same as the current array element.

  2. Expression − This evaluates to the array you need to loop through. The expression can be an array variable or method call that returns an array.

Example

在此示例中,我们展示了使用 foreach 循环打印数组内容。此处我们创建一个名为 numbers 的整数数组,并对其初始化一些值。然后使用 foreach 循环,打印每个数字。创建另一个名为 names 的字符串数组,并使用 foreach 循环对其进行迭代以打印每个元素。

In this example, we’re showing the use of a foreach loop to print contents of an array. Here we’re creating an array of integers as numbers and initialized it some values. Then using foreach loop, each number is printed. Another array of strings as names is created and is iterated to print each element using foreach loop.

public class Test {

   public static void main(String args[]) {
      int [] numbers = {10, 20, 30, 40, 50};

      for(int x : numbers ) {
         System.out.print( x );
         System.out.print(",");
      }
      System.out.print("\n");
      String [] names = {"James", "Larry", "Tom", "Lacy"};

      for( String name : names ) {
         System.out.print( name );
         System.out.print(",");
      }
   }
}

Output

10, 20, 30, 40, 50,
James, Larry, Tom, Lacy,

For each Loop 的更多示例

More examples of For each Loop

What is Next?

在下一章中,我们将学习 Java 编程中的决策语句。

In the following chapter, we will be learning about decision making statements in Java programming.

Java - Decision Making

决策结构具有一条或多条要由程序评估或测试的条件,以及在确定条件为真时要执行的语句,并且在确定条件为假时可以选择执行其他语句。

Decision making structures have one or more conditions to be evaluated or tested by the program, along with a statement or statements that are to be executed if the condition is determined to be true, and optionally, other statements to be executed if the condition is determined to be false.

以下是大多数编程语言中常见的典型决策结构的一般形式 −

Following is the general form of a typical decision making structure found in most of the programming languages −

decision making

Java 编程语言提供了以下类型的决策制定语句。单击以下链接以查看它们的详细信息。

Java programming language provides following types of decision making statements. Click the following links to check their detail.

Sr.No.

Statement & Description

1

if statementAn if statement consists of a boolean expression followed by one or more statements.

2

if…​else statementAn if statement can be followed by an optional else statement, which executes when the boolean expression is false.

3

nested if statementYou can use one if or else if statement inside another if or else if statement(s).

4

switch statementA switch statement allows a variable to be tested for equality against a list of values.

The ? : Operator

我们已经在上个章节中介绍了 conditional operator ? :,它可以替换 if…​else 语句。它的通用格式如下 −

We have covered conditional operator ? : in the previous chapter which can be used to replace if…​else statements. It has the following general form −

Exp1 ? Exp2 : Exp3;

其中 Exp1、Exp2 和 Exp3 是表达式。请注意冒号的用处和位置。

Where Exp1, Exp2, and Exp3 are expressions. Notice the use and placement of the colon.

要确定整个表达式的值,最初会求出 exp1 的值。

To determine the value of the whole expression, initially exp1 is evaluated.

  1. If the value of exp1 is true, then the value of Exp2 will be the value of the whole expression.

  2. If the value of exp1 is false, then Exp3 is evaluated and its value becomes the value of the entire expression.

Example

在这个示例中,我们创建了两个变量 a 和 b,并且使用 ternary operator 决定了 b 的值并打印出来了。

In this example, we’re creating two variables a and b and using ternary operator we’ve decided the values of b and printed it.

public class Test {

   public static void main(String args[]) {
      int a, b;
      a = 10;
      b = (a == 1) ? 20: 30;
      System.out.println( "Value of b is : " +  b );

      b = (a == 10) ? 20: 30;
      System.out.println( "Value of b is : " + b );
   }
}

Output

Value of b is : 30
Value of b is : 20

What is Next?

在下一章节中,我们将讨论数字类(在 java.lang 包中)及其在 Java 语言中的子类。

In the next chapter, we will discuss about Number class (in the java.lang package) and its subclasses in Java Language.

我们将研究一些这种情况,在这些情况下,您将使用这些类的实例化,而不是原始数据类型,以及在使用数字时您需要了解的格式化、数学函数等类。

We will be looking into some of the situations where you will use instantiations of these classes rather than the primitive data types, as well as classes such as formatting, mathematical functions that you need to know about when working with Numbers.

Java - if-else statement

if 语句后面可以紧跟一个可选的 else 语句,该语句在布尔表达式为假时执行。

An if statement can be followed by an optional else statement, which executes when the Boolean expression is false.

Syntax

以下是 if…else 语句的语法:

Following is the syntax of an if…​else statement −

if(Boolean_expression) {
   // Executes when the Boolean expression is true
}else {
   // Executes when the Boolean expression is false
}

如果布尔表达式求值为 true,则将执行 if 代码块,否则将执行 else 代码块。

If the boolean expression evaluates to true, then the if block of code will be executed, otherwise else block of code will be executed.

Flow Diagram

if else statement

Example 1

在此示例中,我们展示了 if else 语句的使用。我们创建了一个变量 x 并将其初始化为 30。然后在 if 语句中,我们用 20 检查 x。由于 if 语句是 false,因此执行 else 块中的语句。

In this example, we’re showing the usage of if else statement. We’ve created a variable x and initialized it to 30. Then in the if statement, we’re checking x with 20. As if statement is false, the statement within the else block is executed.

public class Test {

   public static void main(String args[]) {
      int x = 30;

      if( x < 20 ) {
         System.out.print("This is if statement");
      }else {
         System.out.print("This is else statement");
      }
   }
}

Output

This is else statement

The if…​else if…​else Statement

一个 if 语句后面可以跟一个可选的 else if…else 语句,该语句对于使用单个 if…else if 语句测试各种条件非常有用。

An if statement can be followed by an optional else if…​else statement, which is very useful to test various conditions using single if…​else if statement.

在使用 if、else if、else 语句时,有几点需要记住。

When using if, else if, else statements there are a few points to keep in mind.

  1. An if can have zero or one else’s and it must come after any else if’s.

  2. An if can have zero to many else if’s and they must come before the else.

  3. Once an else if succeeds, none of the remaining else if’s or else’s will be tested.

Syntax

以下是 if…else 语句的语法:

Following is the syntax of an if…​else statement −

if(Boolean_expression 1) {
   // Executes when the Boolean expression 1 is true
}else if(Boolean_expression 2) {
   // Executes when the Boolean expression 2 is true
}else if(Boolean_expression 3) {
   // Executes when the Boolean expression 3 is true
}else {
   // Executes when the none of the above condition is true.
}

Example 2

在此示例中,我们展示了 if…else if…else 语句的使用。我们创建了一个变量 x 并将其初始化为 30。然后在 if 语句中,我们用 10 检查 x。由于 if 语句是 false,控制权跳转到 else if 语句,用另一个值检查 x,依此类推。

In this example, we’re showing the usage of if…​else if…​else statement. We’ve created a variable x and initialized it to 30. Then in the if statement, we’re checking x with 10. As if statement is false, control jumps to else if statement checking another value with x and so on.

public class Test {

   public static void main(String args[]) {
      int x = 30;

      if( x == 10 ) {
         System.out.print("Value of X is 10");
      }else if( x == 20 ) {
         System.out.print("Value of X is 20");
      }else if( x == 30 ) {
         System.out.print("Value of X is 30");
      }else {
         System.out.print("This is else statement");
      }
   }
}

Output

Value of X is 30

Example 3

在此示例中,我们展示了 if…else if…else 语句的使用。我们创建了一个变量 x 并将其初始化为 30.0。然后在 if 语句中,我们用 10,0 检查 x。由于 if 语句是 false,控制权跳转到 else if 语句,用另一个值检查 x,依此类推。

In this example, we’re showing the usage of if…​else if…​else statement. We’ve created a variable x and initialized it to 30.0. Then in the if statement, we’re checking x with 10,0. As if statement is false, control jumps to else if statement checking another value with x and so on.

public class Test {

   public static void main(String args[]) {
      double x = 30.0;

      if( x == 10.0 ) {
         System.out.print("Value of X is 10.0");
      }else if( x == 20.0 ) {
         System.out.print("Value of X is 20.0");
      }else if( x == 30.0 ) {
         System.out.print("Value of X is 30.0");
      }else {
         System.out.print("This is else statement");
      }
   }
}

Output

Value of X is 30.0

Java - switch statement

一个 switch 语句允许变量针对一组值进行相等性测试。每个值称为一个 case,并且正在切换的变量针对每个 case 进行检查。

A switch statement allows a variable to be tested for equality against a list of values. Each value is called a case, and the variable being switched on is checked for each case.

Syntax

增强 switch 语句的语法为:

The syntax of enhanced switch statement is −

switch(expression) {
   case value :
      // Statements
      break; // optional

   case value :
      // Statements
      break; // optional

   // You can have any number of case statements.
   default : // Optional
      // Statements
}

以下规则适用于 switch 语句:

The following rules apply to a switch statement −

  1. The variable used in a switch statement can only be integers, convertable integers (byte, short, char), strings and enums.

  2. You can have any number of case statements within a switch. Each case is followed by the value to be compared to and a colon.

  3. The value for a case must be the same data type as the variable in the switch and it must be a constant or a literal.

  4. When the variable being switched on is equal to a case, the statements following that case will execute until a break statement is reached.

  5. When a break statement is reached, the switch terminates, and the flow of control jumps to the next line following the switch statement.

  6. Not every case needs to contain a break. If no break appears, the flow of control will fall through to subsequent cases until a break is reached.

  7. A switch statement can have an optional default case, which must appear at the end of the switch. The default case can be used for performing a task when none of the cases is true. No break is needed in the default case.

Flow Diagram

switch statement

Example 1

在此示例中,我们展示了 switch 语句的使用,其中 case 基于字符。我们创建了一个变量 grade。根据 grade 的值,检查每个 case。如果满足了一个 case 并且存在 break 语句,则不会检查后续 case。

In this example, we’re showing use of switch statement where cases are based on a char. We’ve created a variable grade. Based on value of grade, each case is checked. if a case is satisfied and break statement is present then following cases are not checked.

public class Test {

   public static void main(String args[]) {
      char grade = 'C';

      switch(grade) {
         case 'A' :
            System.out.println("Excellent!");
            break;
         case 'B' :
         case 'C' :
            System.out.println("Well done");
            break;
         case 'D' :
            System.out.println("You passed");
         case 'F' :
            System.out.println("Better try again");
            break;
         default :
            System.out.println("Invalid grade");
      }
      System.out.println("Your grade is " + grade);
   }
}

使用各种命令行参数编译并运行上述程序。这会产生以下结果:

Compile and run the above program using various command line arguments. This will produce the following result −

Output

Well done
Your grade is C

Example 2

在此示例中,我们将展示基于 int 的交换语句的使用方法。我们创建了一个变量 grade。根据 grade 的值,检查每个 case。如果 case 满足并且有 break 语句,则后续 case 将不会被检查。

In this example, we’re showing use of switch statement where cases are based on a int. We’ve created a variable grade. Based on value of grade, each case is checked. if a case is satisfied and break statement is present then following cases are not checked.

public class Test {

   public static void main(String args[]) {
      int grade = 3;

      switch(grade) {
         case 1 :
            System.out.println("Excellent!");
            break;
         case 2 :
         case 3 :
            System.out.println("Well done");
            break;
         case 4 :
            System.out.println("You passed");
         case 5 :
            System.out.println("Better try again");
            break;
         default :
            System.out.println("Invalid grade");
      }
      System.out.println("Your grade is " + grade);
   }
}

使用各种命令行参数编译并运行上述程序。这会产生以下结果:

Compile and run the above program using various command line arguments. This will produce the following result −

Output

Well done
Your grade is 3

Example 3

在此示例中,我们将展示基于字符串的交换语句的使用方法。我们创建了一个变量 grade。根据 grade 的值,检查每个 case。如果 case 满足并且有 break 语句,则后续 case 将不会被检查。

In this example, we’re showing use of switch statement where cases are based on a String. We’ve created a variable grade. Based on value of grade, each case is checked. if a case is satisfied and break statement is present then following cases are not checked.

public class Test {

   public static void main(String args[]) {
      String grade = "C";

      switch(grade) {
         case "A" :
            System.out.println("Excellent!");
            break;
         case "B" :
         case "C" :
            System.out.println("Well done");
            break;
         case "D" :
            System.out.println("You passed");
         case "F" :
            System.out.println("Better try again");
            break;
         default :
            System.out.println("Invalid grade");
      }
      System.out.println("Your grade is " + grade);
   }
}

使用各种命令行参数编译并运行上述程序。这会产生以下结果:

Compile and run the above program using various command line arguments. This will produce the following result −

Output

Well done
Your grade is C

Java - for Loop

for 循环是一种重复控制结构,允许您高效地编写需要执行特定次数的循环。

A for loop is a repetition control structure that allows you to efficiently write a loop that needs to be executed a specific number of times.

for 循环在你知道任务重复多少次时会很有用。

A for loop is useful when you know how many times a task is to be repeated.

Syntax

for 循环的语法为:

The syntax of a for loop is −

for(initialization; Boolean_expression; update) {
   // Statements
}

以下是 for 循环中的控制流程:

Here is the flow of control in a for loop −

  1. The initialization step is executed first, and only once. This step allows you to declare and initialize any loop control variables and this step ends with a semi colon (;).

  2. Next, the Boolean expression is evaluated. If it is true, the body of the loop is executed. If it is false, the body of the loop will not be executed and control jumps to the next statement past the for loop.

  3. After the body of the for loop gets executed, the control jumps back up to the update statement. This statement allows you to update any loop control variables. This statement can be left blank with a semicolon at the end.

  4. The Boolean expression is now evaluated again. If it is true, the loop executes and the process repeats (body of loop, then update step, then Boolean expression). After the Boolean expression is false, the for loop terminates.

Flow Diagram

java for loop

Example 1

在此示例中,我们将展示如何使用 for 循环来打印从 10 到 19 的数字。在此,我们在 for 循环的初始化块中初始化了一个 int 变量 x,值为 10。然后,在表达式块中,我们检查 x 是否小于 20,并且最后在更新块中,我们把 x 加 1。在 for 循环的代码块中,我们打印 x 的值。for 循环会一直运行直到 x 变为 20。一旦 x 为 20,循环就会停止执行,程序会退出。

In this example, we’re showing the use of a for loop to print numbers starting from 10 to 19. Here we’ve initialized an int variable x with a value of 10 within initialization blook of for loop. Then in expression block, we’re checking x as less than 20, and in the end under update block, we’re incrementing x by 1. Within body of for loop, we’re printing the value of x. For loop will run until x becomes 20. Once x is 20, loop will stop execution and program exits.

public class Test {

   public static void main(String args[]) {

      for(int x = 10; x < 20; x = x + 1) {
         System.out.print("value of x : " + x );
         System.out.print("\n");
      }
   }
}

Output

value of x : 10
value of x : 11
value of x : 12
value of x : 13
value of x : 14
value of x : 15
value of x : 16
value of x : 17
value of x : 18
value of x : 19

Example 2

在此示例中,我们将展示如何使用 for 循环来打印数组的内容。在这里,我们创建了一个整数数组 numbers,并初始化了一些值。我们已经创建了一个名为 index 的变量来表示 for 循环中数组的索引,并检查它是否小于数组的大小,然后把它加 1。在 for 循环的代码块中,我们使用索引标记法来打印数组的元素。一旦索引与数组大小相同,for 循环就退出,程序就停止。

In this example, we’re showing the use of a for loop to print contents of an array. Here we’re creating an array of integers as numbers and initialized it some values. We’ve created a variable named index to represent index of the array within for loop, check it against size of the array and incremented it by 1. Within for loop body, we’re printing element of the array using index notation. Once index becomes same as array size, for loop exits and program quits.

public class Test {

   public static void main(String args[]) {
      int [] numbers = {10, 20, 30, 40, 50};

      for(int index = 0; index < numbers.length; index++) {
         System.out.print("value of item : " + numbers[index] );
         System.out.print("\n");
      }
   }
}

Output

value of item : 10
value of item : 20
value of item : 30
value of item : 40
value of item : 50

Example 3

在此示例中,我们展示了使用 for 循环的无限循环。它将继续打印数字,直到您按 Ctrl+c 终止程序。

In this example, we’re showing the infinite loop using for loop. It will keep printing the numbers until you press ctrl+c to terminate the program.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      for( ;; ) {
         System.out.print("value of x : " + x );
         x++;
         System.out.print("\n");
      }
   }
}

Output

value of item : 10
value of item : 11
value of item : 12
value of item : 13
value of item : 14
...
ctrl+c

Java - for each Loop

for each 循环是一种特殊的重复控制结构,它能让你高效地编写需要执行特定次数的循环。

A for each loop is a special repetition control structure that allows you to efficiently write a loop that needs to be executed a specific number of times.

即使您不知道任务要重复多少次,for each 循环也很有用。

A for each loop is useful even when you do not know how many times a task is to be repeated.

Syntax

以下是增强型 for 循环的语法:

Following is the syntax of enhanced for loop −

for(declaration : expression) {
   // Statements
}
  1. Declaration − The newly declared block variable, is of a type compatible with the elements of the array you are accessing. The variable will be available within the for block and its value would be the same as the current array element.

  2. Expression − This evaluates to the array you need to loop through. The expression can be an array variable or method call that returns an array.

Example 1

在此示例中,演示了使用 foreach 循环打印整数列表内容。此处将整数列表创建为数字,并初始化为一些值。然后,使用 foreach 循环打印每个数字。

In this example, we’re showing the use of a foreach loop to print contents of an List of Integers. Here we’re creating an List of integers as numbers and initialized it some values. Then using foreach loop, each number is printed.

import java.util.Arrays;
import java.util.List;

public class Test {

   public static void main(String args[]) {
      List<Integer> numbers = Arrays.asList(10, 20, 30, 40, 50);

      for(Integer x : numbers ) {
         System.out.print( x );
         System.out.print(",");
      }
   }
}

Output

10, 20, 30, 40, 50,

Example 2

在此示例中,我们展示如何使用 foreach 循环来打印 String List 的内容。在此,我们创建了一个字符串数组 names,并初始化了一些值。然后,使用 foreach 循环打印每个名称。

In this example, we’re showing the use of a foreach loop to print contents of an List of String. Here we’re creating an array of Strings as names and initialized it some values. Then using foreach loop, each name is printed.

import java.util.Arrays;
import java.util.List;

public class Test {

   public static void main(String args[]) {
      List<String> names = Arrays.asList("James", "Larry", "Tom", "Lacy");

      for( String name : names ) {
         System.out.print( name );
         System.out.print(",");
      }
   }
}

Output

James, Larry, Tom, Lacy,

Example 3

在此示例中,我们展示如何使用 foreach 循环来打印 Student Object 数组的内容。在此,我们创建了一个学生数组 Student Objects,并初始化了一些值。然后,使用 foreach 循环打印每个名称。

In this example, we’re showing the use of a foreach loop to print contents of an array of Student Object. Here we’re creating an array of Students as Student object and initialized it some values. Then using foreach loop, each name is printed.

public class Test {

   public static void main(String args[]) {
      Student[] students = { new Student(1, "Julie"), new Student(3, "Adam"), new Student(2, "Robert") };

      for( Students student : students ) {
         System.out.print( student );
         System.out.print(",");
      }
   }
}
class Student {
   int rollNo;
   String name;

   Student(int rollNo, String name){
      this.rollNo = rollNo;
      this.name = name;
   }

   @Override
   public String toString() {
      return "[ " + this.rollNo + ", " + this.name + " ]";
   }
}

Output

[ 1, Julie ],[ 3, Adam ],[ 2, Robert ],

Java - while Loop

Java 编程语言中的 while 循环语句只要给定的条件为真,就会重复执行目标语句。

A while loop statement in Java programming language repeatedly executes a target statement as long as a given condition is true.

Syntax

while 循环的语法为 −

The syntax of a while loop is −

while(Boolean_expression) {
   // Statements
}

在此处,statement(s) 可能是一个简单的语句或一个语句块。condition 可能是任意表达式,并且 true 是任意非零值。

Here, statement(s) may be a single statement or a block of statements. The condition may be any expression, and true is any non zero value.

执行时,如果 boolean_expression 结果为真,那么循环内部的操作将被执行。只要该表达式结果为真,此操作就会继续。

When executing, if the boolean_expression result is true, then the actions inside the loop will be executed. This will continue as long as the expression result is true.

当条件变为假时,程序控制权将传递到循环之后的行。

When the condition becomes false, program control passes to the line immediately following the loop.

Flow Diagram

java while loop

这里,while 循环的关键是此循环可能永远不会运行。当表达式的结果为 false 时,循环的代码块将会被跳过,并且将执行 while 循环之后的第一个语句。

Here, key point of the while loop is that the loop might not ever run. When the expression is tested and the result is false, the loop body will be skipped and the first statement after the while loop will be executed.

Example 1

在此示例中,我们展示如何使用 while 循环来打印从 10 到 19 的数字。在此,我们初始化了一个 int 变量 x,值为 10。然后,在 while 循环中,我们检查 x 是否小于 20,并且在 while 循环中,我们打印 x 的值并且让 x 的值加 1。while 循环会一直运行直到 x 变为 20。一旦 x 为 20,循环就会停止执行,程序会退出。

In this example, we’re showing the use of a while loop to print numbers starting from 10 to 19. Here we’ve initialized an int variable x with a value of 10. Then in while loop, we’re checking x as less than 20 and within while loop, we’re printing the value of x and incrementing the value of x by 1. While loop will run until x becomes 20. Once x is 20, loop will stop execution and program exits.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      while( x < 20 ) {
         System.out.print("value of x : " + x );
         x++;
         System.out.print("\n");
      }
   }
}

Output

value of x : 10
value of x : 11
value of x : 12
value of x : 13
value of x : 14
value of x : 15
value of x : 16
value of x : 17
value of x : 18
value of x : 19

Example 2

在此示例中,我们展示如何使用 while 循环来打印数组的内容。在这里,我们创建了一个整数数组 numbers,并初始化了一些值。我们已经创建了一个名为 index 的变量来表示遍历数组时的数组索引。在 while 循环中,我们检查索引是否小于数组的大小,然后使用索引标记法打印数组的元素。index 变量加 1,并且循环会持续到索引变为数组的规定大小为止,然后循环退出。

In this example, we’re showing the use of a while loop to print contents of an array. Here we’re creating an array of integers as numbers and initialized it some values. We’ve created a variable named index to represent index of the array while iterating it. In while loop we’re checking the index to be less than size of the array and printed the element of the array using index notation. index variable is incremented by 1 and loop continues till index becomes the sie of the array and loop exits.

public class Test {

   public static void main(String args[]) {
      int [] numbers = {10, 20, 30, 40, 50};
      int index = 0;

      while( index < 5 ) {
         System.out.print("value of item : " + numbers[index] );
         index++;
         System.out.print("\n");
      }
   }
}

Output

value of item : 10
value of item : 20
value of item : 30
value of item : 40
value of item : 50

Example 3

在这个示例中,我们展示了使用 while 循环的无限循环。它将继续打印数字,直到你按 ctrl+c 终止程序。

In this example, we’re showing the infinite loop using while loop. It will keep printing the numbers until you press ctrl+c to terminate the program.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      while( true ) {
         System.out.print("value of x : " + x );
         x++;
         System.out.print("\n");
      }
   }
}

Output

value of item : 10
value of item : 20
value of item : 30
value of item : 40
value of item : 50
...
ctrl+c

Java - do…​while Loop

do…​while 循环与 while 循环类似,不同之处在于 do…​while 循环保证至少执行一次。

A do…​while loop is similar to a while loop, except that a do…​while loop is guaranteed to execute at least one time.

Syntax

以下是 do…​while 循环的语法:

Following is the syntax of a do…​while loop −

do {
   // Statements
}while(Boolean_expression);

请注意布尔表达式出现在循环的末尾,因此循环中的语句在检查布尔表达式之前执行一次。

Notice that the Boolean expression appears at the end of the loop, so the statements in the loop execute once before the Boolean is tested.

如果布尔表达式为真,控制权就会跳转回 do 语句,循环中的语句会再次执行。此过程会重复运行,直到布尔表达式为假为止。

If the Boolean expression is true, the control jumps back up to do statement, and the statements in the loop execute again. This process repeats until the Boolean expression is false.

Flow Diagram

java do while loop

Example 1

在此示例中,我们展示如何使用 while 循环来打印从 10 到 19 的数字。在此,我们初始化了一个 int 变量 x,值为 10。然后,在 do while 循环中,我们在 do while 循环代码块中检查 x 是否小于 20。在 do while 循环代码块中,我们打印 x 的值,并且把 x 的值加 1。while 循环会一直运行直到 x 变为 20。一旦 x 为 20,循环就会停止执行,程序会退出。

In this example, we’re showing the use of a while loop to print numbers starting from 10 to 19. Here we’ve initialized an int variable x with a value of 10. Then in do while loop, we’re checking x as less than 20 after do while loop body.In do while loop body we’re printing the value of x and incrementing the value of x by 1. While loop will run until x becomes 20. Once x is 20, loop will stop execution and program exits.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      do {
         System.out.print("value of x : " + x );
         x++;
         System.out.print("\n");
      }while( x < 20 );
   }
}

Output

value of x : 10
value of x : 11
value of x : 12
value of x : 13
value of x : 14
value of x : 15
value of x : 16
value of x : 17
value of x : 18
value of x : 19

Example 2

在此示例中,我们展示如何使用 do while 循环来打印数组的内容。在这里,我们创建了一个整数数组 numbers,并初始化了一些值。我们已经创建了一个名为 index 的变量来表示遍历数组时的数组索引。在 do while 循环中,我们在循环代码块之后检查索引是否小于数组的大小,然后使用索引标记法打印数组的元素。在循环代码块中,index 变量加 1,并且循环会持续到索引变为数组的规定大小为止,然后循环退出。

In this example, we’re showing the use of a do while loop to print contents of an array. Here we’re creating an array of integers as numbers and initialized it some values. We’ve created a variable named index to represent index of the array while iterating it. In do while loop we’re checking the index to be less than size of the array after loop body and printed the element of the array using index notation. Within loop body index variable is incremented by 1 and loop continues till index becomes the sie of the array and loop exits.

public class Test {

   public static void main(String args[]) {
      int [] numbers = {10, 20, 30, 40, 50};
      int index = 0;

      do {
         System.out.print("value of item : " + numbers[index] );
         index++;
         System.out.print("\n");
      } while( index < 5 );
   }
}

Output

value of item : 10
value of item : 20
value of item : 30
value of item : 40
value of item : 50

Example 3

在这个示例中,我们展示了使用 while 循环的无限循环。它将继续打印数字,直到你按 ctrl+c 终止程序。

In this example, we’re showing the infinite loop using while loop. It will keep printing the numbers until you press ctrl+c to terminate the program.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      do {
         System.out.print("value of x : " + x );
         x++;
         System.out.print("\n");
      } while( true );
   }
}

Output

value of item : 10
value of item : 20
value of item : 30
value of item : 40
value of item : 50
...
ctrl+c

Java - break statement

Java 编程语言中的 break 语句具有以下两个用法:

The break statement in Java programming language has the following two usages −

  1. When the break statement is encountered inside a loop, the loop is immediately terminated and the program control resumes at the next statement following the loop.

  2. It can be used to terminate a case in the switch statement (covered in the next chapter).

Syntax

break 语法的结构是任一循环中的一条单独语句:

The syntax of a break is a single statement inside any loop −

break;

Flow Diagram

java break statement

Example 1

在这个示例中,我们展示了如何使用 break 语句来中断一个 while 循环,以打印从 10 到 14 的数字,而没有 break 语句,将会打印到 19。在这里,我们使用值 10 初始化了一个 int 变量 x。然后在 while 循环中,我们检查 x 是否小于 20,并且在 while 循环内,我们打印 x 的值并使 x 的值增加 1。while 循环将一直运行,直到 x 变成 15。一旦 x 变成 15,break 语句将中断 while 循环,程序退出。

In this example, we’re showing the use of a break statement to break a while loop to print numbers starting from 10 to 14 which will otherwise print element till 19. Here we’ve initialized an int variable x with a value of 10. Then in while loop, we’re checking x as less than 20 and within while loop, we’re printing the value of x and incrementing the value of x by 1. While loop will run until x becomes 15. Once x is 15, break statement will break the while loop and program exits.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      while( x < 20 ) {
         if(x == 15){
            break;
         }
         System.out.print("value of x : " + x );
         x++;
         System.out.print("\n");
      }
   }
}

Output

value of x : 10
value of x : 11
value of x : 12
value of x : 13
value of x : 14

Example 2

在这个示例中,我们展示了如何在 for 循环中使用 break 语句来打印数组的一些元素,而不是所有元素。在这里,我们创建一个名为 numbers 的整数数组,并初始化为一些值。我们创建了一个名为 index 的变量,以表示 for 循环中数组的索引,并检查数组的大小,并使其增加 1。在 for 循环体中,我们使用索引表示法打印数组元素。一旦遇到值为 30,break 语句将中断 for 循环,程序退出。

In this example, we’re showing the use of a break statement within a for loop to print few elements of an array instead of all elements. Here we’re creating an array of integers as numbers and initialized it some values. We’ve created a variable named index to represent index of the array within for loop, check it against size of the array and incremented it by 1. Within for loop body, we’re printing element of the array using index notation. Once 30 is encountered as value, break statement breaks the flow of for loop and program quits.

public class Test {

   public static void main(String args[]) {
      int [] numbers = {10, 20, 30, 40, 50};

      for(int index = 0; index < numbers.length; index++) {
         if(numbers[index] == 30){
            break;
         }
         System.out.print("value of item : " + numbers[index] );
         System.out.print("\n");
      }
   }
}

Output

value of item : 10
value of item : 20

Example 3

在示例中,我们展示使用 break 语句使用 while 循环来中断无限循环。它将继续打印数字,直到 x 的值变为 15.

In this example, we’re showing the use of break statement to break an infinite loop using while loop. It will keep printing the numbers until the value of x becomes 15.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      while( true ) {
         System.out.print("value of x : " + x );
         x++;
         if(x == 15) {
            break;
         }
         System.out.print("\n");
      }
   }
}

Output

value of item : 10
value of item : 11
value of item : 12
value of item : 13
value of item : 14

Java - continue statement

continue 关键字可以在任何循环控制结构中使用。它导致循环立即跳转到循环的下一个迭代。

The continue keyword can be used in any of the loop control structures. It causes the loop to immediately jump to the next iteration of the loop.

  1. In a for loop, the continue keyword causes control to immediately jump to the update statement.

  2. In a while loop or do/while loop, control immediately jumps to the Boolean expression.

Syntax

continue 的语法是在任何循环内单条语句 −

The syntax of a continue is a single statement inside any loop −

continue;

Flow Diagram

java continue statement

Example 1

在这个示例中,我们展示了如何在 while 循环中使用 continue 语句跳过元素 15,该 while 循环用于打印 10 到 19 的元素。在这里,我们使用值 10 初始化了一个 int 变量 x。然后在 while 循环中,我们检查 x 是否小于 20,并且在 while 循环内,我们打印 x 的值并使 x 的值增加 1。while 循环将一直运行,直到 x 变成 15。一旦 x 变成 15,continue 语句将在跳过主体执行的同时跳出 while 循环,并且循环将继续。

In this example, we’re showing the use of a continue statement to skip an element 15 in a while loop which is used to print element from 10 to 19. Here we’ve initialized an int variable x with a value of 10. Then in while loop, we’re checking x as less than 20 and within while loop, we’re printing the value of x and incrementing the value of x by 1. While loop will run until x becomes 15. Once x is 15, continue statement will jump the while loop while skipping the execution of the body and loop continues.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      while( x < 20 ) {
         x++;
         if(x == 15){
            continue;
         }
         System.out.print("value of x : " + x );
         System.out.print("\n");
      }
   }
}

Output

value of x : 11
value of x : 12
value of x : 13
value of x : 14
value of x : 16
value of x : 17
value of x : 18
value of x : 19
value of x : 20

Example 2

在这个示例中,我们展示了如何在 for 循环中使用 continue 语句跳过数组元素以进行打印。在这里,我们创建一个名为 numbers 的整数数组,并初始化为一些值。我们创建了一个名为 index 的变量,以表示 for 循环中数组的索引,并检查数组的大小,并使其增加 1。在 for 循环体中,我们使用索引表示法打印数组元素。一旦遇到值为 30,continue 语句将跳转到 for 循环的更新部分,并且循环将继续。

In this example, we’re showing the use of a continue statement within a for loop to skip an elements of an array to print. Here we’re creating an array of integers as numbers and initialized it some values. We’ve created a variable named index to represent index of the array within for loop, check it against size of the array and incremented it by 1. Within for loop body, we’re printing element of the array using index notation. Once 30 is encountered as value, continue statement jumps to the update section of for loop and loop continues.

public class Test {

   public static void main(String args[]) {
      int [] numbers = {10, 20, 30, 40, 50};

      for(int index = 0; index < numbers.length; index++) {
         if(numbers[index] == 30){
            continue;
         }
         System.out.print("value of item : " + numbers[index] );
         System.out.print("\n");
      }
   }
}

Output

value of item : 10
value of item : 20
value of item : 40
value of item : 50

Example 3

在此示例中,我们展示了使用 continue 语句在 do while 循环中跳过元素 15 的用法,该循环用于打印从 10 到 19 的元素。此处,我们使用值 10 初始化了 int 变量 x。然后在 do while 循环中,我们在主体和 while 循环内检查 x 是否小于 20,打印 x 的值并将其增加 1。while 循环将运行,直至 x 变成 15。x 一旦变成 15,continue 语句将使 while 循环跳过主体执行并进入循环。

In this example, we’re showing the use of a continue statement to skip an element 15 in a do while loop which is used to print element from 10 to 19. Here we’ve initialized an int variable x with a value of 10. Then in do while loop, we’re checking x as less than 20 after body and within while loop, we’re printing the value of x and incrementing the value of x by 1. While loop will run until x becomes 15. Once x is 15, continue statement will jump the while loop while skipping the execution of the body and loop continues.

public class Test {

   public static void main(String args[]) {
      int x = 10;

      do {
         x++;
         if(x == 15){
            continue;
         }
         System.out.print("value of x : " + x );
         System.out.print("\n");
      } while( x < 20 );
   }
}

Output

value of x : 11
value of x : 12
value of x : 13
value of x : 14
value of x : 16
value of x : 17
value of x : 18
value of x : 19
value of x : 20

Java - Object and Classes

Java 是一种面向对象的语言。作为具有面向对象特性的语言,Java 支持以下基本概念:

Java is an Object-Oriented Language. As a language that has the Object-Oriented feature, Java supports the following fundamental concepts −

  1. Polymorphism

  2. Inheritance

  3. Encapsulation

  4. Abstraction

  5. Classes

  6. Objects

  7. Instance

  8. Method

  9. Message Passing

在本章中,我们将研究概念 - 类和对象。

In this chapter, we will look into the concepts - Classes and Objects.

  1. Object − Objects have states and behaviors. Example: A dog has states - color, name, breed as well as behaviors − wagging the tail, barking, eating. An object is an instance of a class.

  2. Class − A class can be defined as a template/blueprint that describes the behavior/state that the object of its type support.

Objects in Java

现在让我们深入了解什么是对象。如果我们考虑现实世界,我们可以在周围找到许多对象,例如汽车、狗、人类,等等。所有这些对象都具有状态和行为。

Let us now look deep into what are objects. If we consider the real-world, we can find many objects around us, cars, dogs, humans, etc. All these objects have a state and a behavior.

如果我们考虑一只狗,那么它的状态是 - 名称、品种、颜色,而它的行为是 - 吠叫、摇尾巴、奔跑。

If we consider a dog, then its state is - name, breed, color, and the behavior is - barking, wagging the tail, running.

如果你将软件对象与现实世界对象进行比较,它们具有非常相似的特性。

If you compare the software object with a real-world object, they have very similar characteristics.

软件对象也具有状态和行为。软件对象的状态存储在字段中,而行为通过方法表现出来。

Software objects also have a state and a behavior. A software object’s state is stored in fields and behavior is shown via methods.

因此,在软件开发中,方法对对象的内部状态进行操作,并且对象到对象之间的通信是通过方法进行的。

So in software development, methods operate on the internal state of an object and the object-to-object communication is done via methods.

Classes in Java

一个类是创建各个对象的蓝图。

A class is a blueprint from which individual objects are created.

下面是一个类的示例。

Following is a sample of a class.

Example

public class Dog {
   String breed;
   int age;
   String color;

   void barking() {
   }

   void hungry() {
   }

   void sleeping() {
   }
}

课程可以包含任何以下变量类型。

A class can contain any of the following variable types.

  1. Local variables − Variables defined inside methods, constructors or blocks are called local variables. The variable will be declared and initialized within the method and the variable will be destroyed when the method has completed.

  2. Instance variables − Instance variables are variables within a class but outside any method. These variables are initialized when the class is instantiated. Instance variables can be accessed from inside any method, constructor or blocks of that particular class.

  3. Class variables − Class variables are variables declared within a class, outside any method, with the static keyword.

一个类可以具有任意数量的方法来访问各种类型的方法的值。在上面的示例中,barking()、hungry() 和 sleeping() 是方法。

A class can have any number of methods to access the value of various kinds of methods. In the above example, barking(), hungry() and sleeping() are methods.

在了解 Java 语言中类时,需要讨论以下一些重要主题。

Following are some of the important topics that need to be discussed when looking into classes of the Java Language.

Constructors

讨论类时,最重要的子主题之一是构造器。任何类都有一个构造器。如果我们没有明确地为类编写一个构造器,那么 Java 编译器将会为该类构建一个默认构造器。

When discussing about classes, one of the most important sub topic would be constructors. Every class has a constructor. If we do not explicitly write a constructor for a class, the Java compiler builds a default constructor for that class.

每次创建一个新对象时,至少会调用一个构造器。构造器的主要规则是,它们应该与类同名。一个类可以有一个以上的构造器。

Each time a new object is created, at least one constructor will be invoked. The main rule of constructors is that they should have the same name as the class. A class can have more than one constructor.

以下是一个构造器的示例:

Following is an example of a constructor −

Example

public class Puppy {
   public Puppy() {
   }

   public Puppy(String name) {
      // This constructor has one parameter, name.
   }
}

Java 也支持 Singleton Classes ,这允许您仅创建一个类的实例。

Java also supports Singleton Classes where you would be able to create only one instance of a class.

Note - 我们有两种不同类型的构造器。我们将在后续章节中详细讨论构造器。

Note − We have two different types of constructors. We are going to discuss constructors in detail in the subsequent chapters.

Creating an Object

正如之前提到的,一个类为对象提供蓝图。所以基本上,一个对象是从一个类创建的。在 Java 中,使用 new 关键字创建新对象。

As mentioned previously, a class provides the blueprints for objects. So basically, an object is created from a class. In Java, the new keyword is used to create new objects.

从一个类创建对象时有三个步骤 −

There are three steps when creating an object from a class −

  1. Declaration − A variable declaration with a variable name with an object type.

  2. Instantiation − The 'new' keyword is used to create the object.

  3. Initialization − The 'new' keyword is followed by a call to a constructor. This call initializes the new object.

以下是如何创建一个对象的示例:

Following is an example of creating an object −

Example

在这个示例中,我们创建了一个名为 Puppy 的类。在 Puppy 类构造器中,要打印 puppy 的名字,这样当创建对象时,就会打印出它的名字。在 main 方法中,使用 new 操作符创建对象。

In this example, We’ve created a class named Puppy. In Puppy class constructor, puppy name is printed so that when the object is created, its name is printed. In main method, an object is created using new operator.

public class Puppy {
   public Puppy(String name) {
      // This constructor has one parameter, <i>name</i>.
      System.out.println("Passed Name is :" + name );
   }

   public static void main(String []args) {
      // Following statement would create an object myPuppy
      Puppy myPuppy = new Puppy( "tommy" );
   }
}

如果我们编译并运行以上程序,它将产生以下结果 −

If we compile and run the above program, then it will produce the following result −

Output

Passed Name is :tommy

Accessing Instance Variables and Methods

实例变量和方法可以通过创建对象来访问。要访问实例变量,以下是完全限定路径 −

Instance variables and methods are accessed via created objects. To access an instance variable, following is the fully qualified path −

/* First create an object */
ObjectReference = new Constructor();

/* Now call a variable as follows */
ObjectReference.variableName;

/* Now you can call a class method as follows */
ObjectReference.MethodName();

Example

在这个示例中,我们创建了一个名为 Puppy 的类。在 Puppy 类构造函数中,打印小狗的名字,以便在创建对象时打印其名字。添加了实例变量 puppyAge,并且可以使用 getter/setter 方法来处理年龄。在 main 方法中,使用 new 运算符创建一个对象。使用 setAge() 方法更新年龄,并且使用 getAge(),打印年龄。

In this example, We’ve created a class named Puppy. In Puppy class constructor, puppy name is printed so that when the object is created, its name is printed. An instance variable puppyAge is added and using getter/setter method, we can manipulate the age. In main method, an object is created using new operator. Age is updated using setAge() method and using getAge(), the age is printed.

public class Puppy {
   int puppyAge;

   public Puppy(String name) {
      // This constructor has one parameter, <i>name</i>.
      System.out.println("Name chosen is :" + name );
   }

   public void setAge( int age ) {
      puppyAge = age;
   }

   public int getAge( ) {
      System.out.println("Puppy's age is :" + puppyAge );
      return puppyAge;
   }

   public static void main(String []args) {
      /* Object creation */
      Puppy myPuppy = new Puppy( "tommy" );

      /* Call class method to set puppy's age */
      myPuppy.setAge( 2 );

      /* Call another class method to get puppy's age */
      myPuppy.getAge( );

      /* You can access instance variable as follows as well */
      System.out.println("Variable Value :" + myPuppy.puppyAge );
   }
}

如果我们编译并运行以上程序,它将产生以下结果 −

If we compile and run the above program, then it will produce the following result −

Output

Name chosen is :tommy
Puppy's age is :2
Variable Value :2

Source File Declaration Rules

作为本部分的最后一部分,现在让我们了解源文件声明规则。在源文件中声明类、导入语句和包语句时,这些规则至关重要。

As the last part of this section, let’s now look into the source file declaration rules. These rules are essential when declaring classes, import statements and package statements in a source file.

  1. There can be only one public class per source file.

  2. A source file can have multiple non-public classes.

  3. The public class name should be the name of the source file as well which should be appended by .java at the end. For example − the class name is public class Employee{} then the source file should be as Employee.java.

  4. If the class is defined inside a package, then the package statement should be the first statement in the source file.

  5. If import statements are present, then they must be written between the package statement and the class declaration. If there are no package statements, then the import statement should be the first line in the source file.

  6. Import and package statements will imply to all the classes present in the source file. It is not possible to declare different import and/or package statements to different classes in the source file.

类有几个不同的访问级别,还有不同的类型,如抽象类、final 类等。我们将在访问修饰符章节中解释所有这些。

Classes have several access levels and there are different types of classes; abstract classes, final classes, etc. We will be explaining about all these in the access modifiers chapter.

除了上述类型的类之外,Java 还有一些称为内部类和匿名类的特殊类。

Apart from the above mentioned types of classes, Java also has some special classes called Inner classes and Anonymous classes.

Java Package

简单地说,它是一种对类和接口进行分类的方法。在 Java 中开发应用程序时,将会编写数百个类和接口,因此对这些类进行分类是必须的,而且会让生活变得轻松得多。

In simple words, it is a way of categorizing the classes and interfaces. When developing applications in Java, hundreds of classes and interfaces will be written, therefore categorizing these classes is a must as well as makes life much easier.

Import Statements

在 Java 中,如果提供了完全限定名称(包括包和类名),那么编译器就可以轻松地找到源代码或类。导入语句是一种为编译器提供适当位置以找到特定类的方法。

In Java if a fully qualified name, which includes the package and the class name is given, then the compiler can easily locate the source code or classes. Import statement is a way of giving the proper location for the compiler to find that particular class.

例如,以下这行会要求编译器加载目录 java_installation/java/io 中可用的所有类:

For example, the following line would ask the compiler to load all the classes available in directory java_installation/java/io −

import java.io.*;

A Simple Case Study

对于我们的案例研究,我们将创建两个类。它们是 Employee 和 EmployeeTest。

For our case study, we will be creating two classes. They are Employee and EmployeeTest.

首先打开记事本并添加以下代码。请记住,这是 Employee 类,并且该类是一个公共类。现在,使用 Employee.java 的名称保存此源文件。

First open notepad and add the following code. Remember this is the Employee class and the class is a public class. Now, save this source file with the name Employee.java.

Employee 类有四个实例变量:name、age、designation 和 salary。该类有一个明确定义的构造函数,它接受一个参数。

The Employee class has four instance variables - name, age, designation and salary. The class has one explicitly defined constructor, which takes a parameter.

Example

import java.io.*;
public class Employee {

   String name;
   int age;
   String designation;
   double salary;

   // This is the constructor of the class Employee
   public Employee(String name) {
      this.name = name;
   }

   // Assign the age of the Employee  to the variable age.
   public void empAge(int empAge) {
      age = empAge;
   }

   /* Assign the designation to the variable designation.*/
   public void empDesignation(String empDesig) {
      designation = empDesig;
   }

   /* Assign the salary to the variable	salary.*/
   public void empSalary(double empSalary) {
      salary = empSalary;
   }

   /* Print the Employee details */
   public void printEmployee() {
      System.out.println("Name:"+ name );
      System.out.println("Age:" + age );
      System.out.println("Designation:" + designation );
      System.out.println("Salary:" + salary);
   }
}

正如本教程中前面提到的,处理从 main 方法开始。因此,为了让我们运行这个 Employee 类,应该有一个 main 方法并且应该创建对象。我们为这些任务创建一个单独的类。

As mentioned previously in this tutorial, processing starts from the main method. Therefore, in order for us to run this Employee class there should be a main method and objects should be created. We will be creating a separate class for these tasks.

以下是 EmployeeTest 类,它创建两个 Employee 类实例,并为每个对象调用方法来为每个变量分配值。

Following is the EmployeeTest class, which creates two instances of the class Employee and invokes the methods for each object to assign values for each variable.

将以下代码保存在 EmployeeTest.java 文件中。

Save the following code in EmployeeTest.java file.

import java.io.*;
public class EmployeeTest {

   public static void main(String args[]) {
      /* Create two objects using constructor */
      Employee empOne = new Employee("James Smith");
      Employee empTwo = new Employee("Mary Anne");

      // Invoking methods for each object created
      empOne.empAge(26);
      empOne.empDesignation("Senior Software Engineer");
      empOne.empSalary(1000);
      empOne.printEmployee();

      empTwo.empAge(21);
      empTwo.empDesignation("Software Engineer");
      empTwo.empSalary(500);
      empTwo.printEmployee();
   }
}

现在,编译这两个类,然后运行 EmployeeTest 以查看结果,如下所示 −

Now, compile both the classes and then run EmployeeTest to see the result as follows −

Output

C:\> javac Employee.java
C:\> javac EmployeeTest.java
C:\> java EmployeeTest
Name:James Smith
Age:26
Designation:Senior Software Engineer
Salary:1000.0
Name:Mary Anne
Age:21
Designation:Software Engineer
Salary:500.0

What is Next?

在下一部分中,我们将讨论 Java 中的基本数据类型,以及如何在开发 Java 应用程序时使用它们。

In the next session, we will discuss the basic data types in Java and how they can be used when developing Java applications.

Java - Methods

Java 方法是一组语句的集合,这些语句被分组在一起执行操作。例如,当你调用 System.out.println() 方法时,系统实际上执行了很多语句以便在控制台中显示一条消息。

A Java method is a collection of statements that are grouped together to perform an operation. When you call the System.out.println() method, for example, the system actually executes several statements in order to display a message on the console.

现在,你将学习如何创建自己的方法,这些方法有返回值或没有返回值,调用有参数或没有参数的方法和在程序设计中应用方法抽象化。

Now you will learn how to create your own methods with or without return values, invoke a method with or without parameters, and apply method abstraction in the program design.

Creating Method

考虑以下示例来解释一个方法的语法 −

Considering the following example to explain the syntax of a method −

Syntax

public static int methodName(int a, int b) {
   // body
}

在此,

Here,

  1. public static − modifier

  2. int − return type

  3. methodName − name of the method

  4. a, b − formal parameters

  5. int a, int b − list of parameters

方法定义包括方法头和方法体。在下述语法中显示了相同的内容:

Method definition consists of a method header and a method body. The same is shown in the following syntax −

Syntax

modifier returnType nameOfMethod (Parameter List) {
   // method body
}

上面显示的语法包括:

The syntax shown above includes −

  1. modifier − It defines the access type of the method and it is optional to use.

  2. returnType − Method may return a value.

  3. nameOfMethod − This is the method name. The method signature consists of the method name and the parameter list.

  4. Parameter List − The list of parameters, it is the type, order, and number of parameters of a method. These are optional, method may contain zero parameters.

  5. method body − The method body defines what the method does with the statements.

Example

以下为命名为*min()*的方法的源代码。此方法获取两个参数 num1 和 num2,然后返回两者之间的较大值:

Here is the source code of the above defined method called min(). This method takes two parameters num1 and num2 and returns the maximum between the two −

/** the snippet returns the minimum between two numbers */

public static int minFunction(int n1, int n2) {
   int min;
   if (n1 > n2)
      min = n2;
   else
      min = n1;

   return min;
}

Method Calling

要使用一个方法,应该调用它。有两种方式可以调用一个方法:方法返回一个值或不返回任何值(没有返回值)。

For using a method, it should be called. There are two ways in which a method is called i.e., method returns a value or returning nothing (no return value).

方法调用的过程很简单。当一个程序调用一个方法时,程序控制将转移到被调用的方法。这个被调用的方法然后在两个条件下将控制返回给调用者,当 −

The process of method calling is simple. When a program invokes a method, the program control gets transferred to the called method. This called method then returns control to the caller in two conditions, when −

  1. the return statement is executed.

  2. it reaches the method ending closing brace.

返回 void 的方法被视为调用语句。我们考虑一个示例−

The methods returning void is considered as call to a statement. Lets consider an example −

System.out.println("This is tutorialspoint.com!");

返回值的方法可以由以下示例理解−

The method returning value can be understood by the following example −

int result = sum(6, 9);

以下是如何定义一个方法以及如何调用它的示例−

Following is the example to demonstrate how to define a method and how to call it −

Example

public class ExampleMinNumber {

   public static void main(String[] args) {
      int a = 11;
      int b = 6;
      int c = minFunction(a, b);
      System.out.println("Minimum Value = " + c);
   }

   /** returns the minimum of two numbers */
   public static int minFunction(int n1, int n2) {
      int min;
      if (n1 > n2)
         min = n2;
      else
         min = n1;

      return min;
   }
}

Output

Minimum value = 6

The void Keyword

void 关键字允许我们创建不返回值的方法。在这里,在以下示例中,我们考虑了一个 void 方法 methodRankPoints。这个方法是一个 void 方法,不返回任何值。对 void 方法的调用必须是一个语句,即 methodRankPoints(255.7);。这是一个 Java 语句,以分号结尾,如下例所示。

The void keyword allows us to create methods which do not return a value. Here, in the following example we’re considering a void method methodRankPoints. This method is a void method, which does not return any value. Call to a void method must be a statement i.e. methodRankPoints(255.7);. It is a Java statement which ends with a semicolon as shown in the following example.

Example

public class ExampleVoid {

   public static void main(String[] args) {
      methodRankPoints(255.7);
   }

   public static void methodRankPoints(double points) {
      if (points >= 202.5) {
         System.out.println("Rank:A1");
      }else if (points >= 122.4) {
         System.out.println("Rank:A2");
      }else {
         System.out.println("Rank:A3");
      }
   }
}

Output

Rank:A1

Passing Parameters by Value

在调用过程中,要传递参数。这些应该与方法规范中它们各自的参数处于相同的顺序。参数可以通过值或引用传递。

While working under calling process, arguments is to be passed. These should be in the same order as their respective parameters in the method specification. Parameters can be passed by value or by reference.

按值传递参数表示用一个参数调用一个方法。通过这种方式,参数值传递给参数。

Passing Parameters by Value means calling a method with a parameter. Through this, the argument value is passed to the parameter.

Example

以下程序显示了一个按值传递参数的示例。即使在方法调用后,参数的值仍然保持不变。

The following program shows an example of passing parameter by value. The values of the arguments remains the same even after the method invocation.

public class swappingExample {

   public static void main(String[] args) {
      int a = 30;
      int b = 45;
      System.out.println("Before swapping, a = " + a + " and b = " + b);

      // Invoke the swap method
      swapFunction(a, b);
      System.out.println("\n**Now, Before and After swapping values will be same here**:");
      System.out.println("After swapping, a = " + a + " and b is " + b);
   }

   public static void swapFunction(int a, int b) {
      System.out.println("Before swapping(Inside), a = " + a + " b = " + b);

      // Swap n1 with n2
      int c = a;
      a = b;
      b = c;
      System.out.println("After swapping(Inside), a = " + a + " b = " + b);
   }
}

Output

Before swapping, a = 30 and b = 45
Before swapping(Inside), a = 30 b = 45
After swapping(Inside), a = 45 b = 30

**Now, Before and After swapping values will be same here**:
After swapping, a = 30 and b is 45

Method Overloading

当一个类有两个或更多具有相同名称但不同参数的方法时,它被称为方法重载。它不同于重写。在重写中,一个方法具有相同的方法名、类型、参数数量等。

When a class has two or more methods by the same name but different parameters, it is known as method overloading. It is different from overriding. In overriding, a method has the same method name, type, number of parameters, etc.

我们考虑前面讨论的用于查找最小整数类型数字的示例。如果我们希望找到最小双精度类型数字。然后将引入重载的概念来创建两个或更多具有相同名称但不同参数的方法。

Let’s consider the example discussed earlier for finding minimum numbers of integer type. If, let’s say we want to find the minimum number of double type. Then the concept of overloading will be introduced to create two or more methods with the same name but different parameters.

以下示例对此进行了说明−

The following example explains the same −

Example

public class ExampleOverloading {

   public static void main(String[] args) {
      int a = 11;
      int b = 6;
      double c = 7.3;
      double d = 9.4;
      int result1 = minFunction(a, b);

      // same function name with different parameters
      double result2 = minFunction(c, d);
      System.out.println("Minimum Value = " + result1);
      System.out.println("Minimum Value = " + result2);
   }

   // for integer
   public static int minFunction(int n1, int n2) {
      int min;
      if (n1 > n2)
         min = n2;
      else
         min = n1;

      return min;
   }

   // for double
   public static double minFunction(double n1, double n2) {
     double min;
      if (n1 > n2)
         min = n2;
      else
         min = n1;

      return min;
   }
}

Output

Minimum Value = 6
Minimum Value = 7.3

方法重载使程序可读。此处,两个方法具有相同的名称,但具有不同的参数。整型和双精度类型中的最小数字是结果。

Overloading methods makes program readable. Here, two methods are given by the same name but with different parameters. The minimum number from integer and double types is the result.

Using Command-Line Arguments

有时,在运行程序时,您将需要向程序传递一些信息。这可以通过将命令行参数传递给 main( ) 来实现。

Sometimes you will want to pass some information into a program when you run it. This is accomplished by passing command-line arguments to main( ).

当执行程序时,紧跟程序名称后的信息就是命令行参数。在 Java 程序中访问命令行参数非常容易。它们被存储为传递给 main( ) 的 String 数组中的字符串。

A command-line argument is the information that directly follows the program’s name on the command line when it is executed. To access the command-line arguments inside a Java program is quite easy. They are stored as strings in the String array passed to main( ).

Example

以下程序显示了它被调用的所有命令行参数 -

The following program displays all of the command-line arguments that it is called with −

public class CommandLine {

   public static void main(String args[]) {
      for(int i = 0; i<args.length; i++) {
         System.out.println("args[" + i + "]: " +  args[i]);
      }
   }
}

尝试按如下所示执行此程序 -

Try executing this program as shown here −

$java CommandLine this is a command line 200 -100

Output

args[0]: this
args[1]: is
args[2]: a
args[3]: command
args[4]: line
args[5]: 200
args[6]: -100

The this keyword

this 是 Java 中的一个关键字,用作当前类对象的引用,它存在于实例方法或构造函数中。通过使用此关键字,您可以引用类的成员,例如构造函数、变量和方法。

this is a keyword in Java which is used as a reference to the object of the current class, with in an instance method or a constructor. Using this you can refer the members of a class such as constructors, variables and methods.

Note− 关键字 this 只用在实例方法或构造函数内

Note − The keyword this is used only within instance methods or constructors

this

一般来说,关键字 this 用于 −

In general, the keyword this is used to −

  1. Differentiate the instance variables from local variables if they have same names, within a constructor or a method.

class Student {
   int age;
   Student(int age) {
      this.age = age;
   }
}
  1. Call one type of constructor (parametrized constructor or default) from other in a class. It is known as explicit constructor invocation.

class Student {
   int age
   Student() {
      this(20);
   }

   Student(int age) {
      this.age = age;
   }
}

Example

以下是一个使用此关键字访问类成员的示例。将以下程序复制并粘贴到名为 This_Example.java 的文件中。

Here is an example that uses this keyword to access the members of a class. Copy and paste the following program in a file with the name, This_Example.java.

public class This_Example {
   // Instance variable num
   int num = 10;

   This_Example() {
      System.out.println("This is an example program on keyword this");
   }

   This_Example(int num) {
      // Invoking the default constructor
      this();

      // Assigning the local variable <i>num</i> to the instance variable <i>num</i>
      this.num = num;
   }

   public void greet() {
      System.out.println("Hi Welcome to Tutorialspoint");
   }

   public void print() {
      // Local variable num
      int num = 20;

      // Printing the local variable
      System.out.println("value of local variable num is : "+num);

      // Printing the instance variable
      System.out.println("value of instance variable num is : "+this.num);

      // Invoking the greet method of a class
      this.greet();
   }

   public static void main(String[] args) {
      // Instantiating the class
      This_Example obj1 = new This_Example();

      // Invoking the print method
      obj1.print();

      // Passing a new value to the num variable through parametrized constructor
      This_Example obj2 = new This_Example(30);

      // Invoking the print method again
      obj2.print();
   }
}

Output

This is an example program on keyword this
value of local variable num is : 20
value of instance variable num is : 10
Hi Welcome to Tutorialspoint
This is an example program on keyword this
value of local variable num is : 20
value of instance variable num is : 30
Hi Welcome to Tutorialspoint

Variable Arguments(var-args)

JDK 1.5 允许您向方法传递可变数量的同类型参数。方法中的参数声明如下 -

JDK 1.5 enables you to pass a variable number of arguments of the same type to a method. The parameter in the method is declared as follows −

typeName... parameterName

在方法声明中,您指定类型,后跟省略号 (…​)。一个方法中只能指定一个可变长度参数,该参数必须是最后一个参数。任何常规参数都必须在它之前。

In the method declaration, you specify the type followed by an ellipsis (…​). Only one variable-length parameter may be specified in a method, and this parameter must be the last parameter. Any regular parameters must precede it.

Example

public class VarargsDemo {

   public static void main(String args[]) {
      // Call method with variable args
	  printMax(34, 3, 3, 2, 56.5);
      printMax(new double[]{1, 2, 3});
   }

   public static void printMax( double... numbers) {
      if (numbers.length == 0) {
         System.out.println("No argument passed");
         return;
      }

      double result = numbers[0];

      for (int i = 1; i <  numbers.length; i++)
      if (numbers[i] >  result)
      result = numbers[i];
      System.out.println("The max value is " + result);
   }
}

Output

The max value is 56.5
The max value is 3.0

The finalize( ) Method

可以定义一种方法,在垃圾收集器对某个对象进行最终销毁之前,将会调用该方法。此方法称为 finalize( ),可用于确保对象干净地终止。

It is possible to define a method that will be called just before an object’s final destruction by the garbage collector. This method is called finalize( ), and it can be used to ensure that an object terminates cleanly.

例如,您可以使用 finalize( ) 确保由该对象拥有的打开文件已关闭。

For example, you might use finalize( ) to make sure that an open file owned by that object is closed.

要为类添加一个终结器,只需定义 finalize( ) 方法。每当 Java 运行时准备回收该类的对象时,就会调用该方法。

To add a finalizer to a class, you simply define the finalize( ) method. The Java runtime calls that method whenever it is about to recycle an object of that class.

在 finalize( ) 方法中,您将指定在销毁对象之前必须执行的操作。

Inside the finalize( ) method, you will specify those actions that must be performed before an object is destroyed.

finalize( ) 方法具有以下常规形式 −

The finalize( ) method has this general form −

protected void finalize( ) {
   // finalization code here
}

此处,关键字 protected 是一个说明符,该说明符阻止定义在其类外部的代码访问 finalize( )。

Here, the keyword protected is a specifier that prevents access to finalize( ) by code defined outside its class.

这意味着你无法知道finalize()何时或是否会被执行。例如,如果你的程序在垃圾收集发生之前结束,则finalize()将不会执行。

This means that you cannot know when or even if finalize( ) will be executed. For example, if your program ends before garbage collection occurs, finalize( ) will not execute.

Java - Constructors

构造函数在创建对象时对该对象进行初始化。它具有与类相同的名称,并且在语法上类似于方法。但是,构造函数没有显式返回类型。

A constructor initializes an object when it is created. It has the same name as its class and is syntactically similar to a method. However, constructors have no explicit return type.

通常,你将使用构造函数为类定义的实例变量赋值,或者执行创建完全成型对象所需的任何其他启动过程。

Typically, you will use a constructor to give initial values to the instance variables defined by the class, or to perform any other start-up procedures required to create a fully formed object.

无论你是否定义了一个构造函数,所有类都具有构造函数,因为 Java 会自动提供一个默认构造函数,将所有成员变量初始化为 0。但是,一旦定义了自己的构造函数,将不再使用默认构造函数。

All classes have constructors, whether you define one or not, because Java automatically provides a default constructor that initializes all member variables to zero. However, once you define your own constructor, the default constructor is no longer used.

Syntax

以下是构造函数的语法 −

Following is the syntax of a constructor −

class ClassName {
   ClassName() {
   }
}

Java 允许使用两种类型的构造函数,分别是 −

Java allows two types of constructors namely −

  1. No argument Constructors

  2. Parameterized Constructors

No argument Constructors

顾名思义,Java 的无参构造函数不接受任何参数,而是使用这些构造函数,将某个方法的实例变量使用固定值初始化为所有对象。

As the name specifies the no argument constructors of Java does not accept any parameters instead, using these constructors the instance variables of a method will be initialized with fixed values for all objects.

Example

Public class MyClass {
   Int num;
   MyClass() {
      num = 100;
   }
}

你可以调用构造函数以如下方式初始化对象:

You would call constructor to initialize objects as follows

public class ConsDemo {
   public static void main(String args[]) {
      MyClass t1 = new MyClass();
      MyClass t2 = new MyClass();
      System.out.println(t1.num + " " + t2.num);
   }
}

Output

100 100

Parameterized Constructors

大多数情况下,您需要接受一个或多个参数的构造函数。将参数添加到构造函数中的方式与将它们添加到方法中的方式相同,只需在构造函数名称后的括号内声明它们即可。

Most often, you will need a constructor that accepts one or more parameters. Parameters are added to a constructor in the same way that they are added to a method, just declare them inside the parentheses after the constructor’s name.

Example

这里有一个使用构造函数的简单示例 −

Here is a simple example that uses a constructor −

// A simple constructor.
class MyClass {
   int x;

   // Following is the constructor
   MyClass(int i ) {
      x = i;
   }
}

您可以按如下方式调用构造函数来初始化对象 −

You would call constructor to initialize objects as follows −

public class ConsDemo {
   public static void main(String args[]) {
      MyClass t1 = new MyClass( 10 );
      MyClass t2 = new MyClass( 20 );
      System.out.println(t1.x + " " + t2.x);
   }
}

Output

10 20

Java - Access Modifiers

Java 提供了许多访问修饰符,用于为类、变量、方法和构造函数设置访问级别。四个访问级别是 −

Java provides a number of access modifiers to set access levels for classes, variables, methods, and constructors. The four access levels are −

  1. Visible to the package, the default. No modifiers are needed.

  2. Visible to the class only (private).

  3. Visible to the world (public).

  4. Visible to the package and all subclasses (protected).

Default Access Modifier - No Keyword

默认访问修饰符表示我们没有显式为类、字段、方法等声明访问修饰符。

Default access modifier means we do not explicitly declare an access modifier for a class, field, method, etc.

在没有访问控制修饰符的情况下声明的变量或方法供相同包中的任何其他类使用。接口中的字段隐式为 public static final,接口中的方法默认情况下为 public。

A variable or method declared without any access control modifier is available to any other class in the same package. The fields in an interface are implicitly public static final and the methods in an interface are by default public.

Example

变量和方法可以在没有任何修饰符的情况下声明,如下例所示:

Variables and methods can be declared without any modifiers, as in the following examples −

String version = "1.5.1";

boolean processOrder() {
   return true;
}

Private Access Modifier - Private

仅在声明的类内部可以访问声明为 private 的方法、变量和构造函数。

Methods, variables, and constructors that are declared private can only be accessed within the declared class itself.

私有访问修饰符是最严格的访问级别。类和接口不能为私有的。

Private access modifier is the most restrictive access level. Class and interfaces cannot be private.

如果类中有 public getter 方法,可以在类的外部访问声明为 private 的变量。

Variables that are declared private can be accessed outside the class, if public getter methods are present in the class.

使用 private 修饰符是对象封装自身和隐藏来自外部世界数据的常用方法。

Using the private modifier is the main way that an object encapsulates itself and hides data from the outside world.

Example

以下类使用私有访问控制:

The following class uses private access control −

public class Logger {
   private String format;

   public String getFormat() {
      return this.format;
   }

   public void setFormat(String format) {
      this.format = format;
   }
}

此处,Logger 类的 format 变量为私有的,因此其他类无法直接获取或设置其值。

Here, the format variable of the Logger class is private, so there’s no way for other classes to retrieve or set its value directly.

所以,为了使此变量可供外部访问,我们定义了两个公共方法:getFormat(),它返回格式的值;和 setFormat(String),它设置其值。

So, to make this variable available to the outside world, we defined two public methods: getFormat(), which returns the value of format, and setFormat(String), which sets its value.

Public Access Modifier - Public

声明为公有的类、方法、构造函数、接口等可从任何其他类访问。因此,可以在属于 Java Universe 的任何类中访问在公共类内部声明的字段、方法和块。

A class, method, constructor, interface, etc. declared public can be accessed from any other class. Therefore, fields, methods, blocks declared inside a public class can be accessed from any class belonging to the Java Universe.

但是,如果我们尝试访问的公共类位于不同的包中,则仍然需要导入公共类。由于类继承,超类的所有公共方法和变量都会被其子类继承。

However, if the public class we are trying to access is in a different package, then the public class still needs to be imported. Because of class inheritance, all public methods and variables of a class are inherited by its subclasses.

Example

以下函数使用公共访问控制 −

The following function uses public access control −

public static void main(String[] arguments) {
   // ...
}

应用程序的 main() 方法必须是公共的。否则,Java 解释器(例如 java)无法调用它来运行类。

The main() method of an application has to be public. Otherwise, it could not be called by a Java interpreter (such as java) to run the class.

Protected Access Modifier - Protected

变量、方法和构造函数在超类中声明为 protected,只能由其他包中的子类或包含受保护成员类包中的任何类来访问。

Variables, methods, and constructors, which are declared protected in a superclass can be accessed only by the subclasses in other package or any class within the package of the protected members' class.

不能将 protected 访问修饰符应用于类和接口。可以将方法、字段声明为 protected,但是不能将接口中的方法和字段声明为 protected。

The protected access modifier cannot be applied to class and interfaces. Methods, fields can be declared protected, however methods and fields in a interface cannot be declared protected.

Protected 访问为子类提供使用助手方法或变量的机会,同时防止不相关的类尝试使用它。

Protected access gives the subclass a chance to use the helper method or variable, while preventing a nonrelated class from trying to use it.

Example

以下父类使用 protected 访问控制,允许其子类重写 openSpeaker() 方法 −

The following parent class uses protected access control, to allow its child class override openSpeaker() method −

class AudioPlayer {
   protected boolean openSpeaker(Speaker sp) {
      // implementation details
   }
}

class StreamingAudioPlayer extends AudioPlayer {
   boolean openSpeaker(Speaker sp) {
      // implementation details
   }
}

在这里,如果我们定义 openSpeaker() 方法为私有的,那么除 AudioPlayer 之外,任何其他类都不能访问它。如果我们将其定义为公有的,那么所有的外部世界都可以访问它。但我们的目的是仅将其方法公开给其子类,这就是我们使用 protected 修饰符的原因。

Here, if we define openSpeaker() method as private, then it would not be accessible from any other class other than AudioPlayer. If we define it as public, then it would become accessible to all the outside world. But our intention is to expose this method to its subclass only, that’s why we have used protected modifier.

Access Control and Inheritance

强制执行以下继承方法规则 −

The following rules for inherited methods are enforced −

  1. Methods declared public in a superclass also must be public in all subclasses.

  2. Methods declared protected in a superclass must either be protected or public in subclasses; they cannot be private.

  3. Methods declared private are not inherited at all, so there is no rule for them.

Example

在此示例中,我们使用 private 变量 age 创建了一个类,并使用 name 作为默认作用域创建了一个变量。使用 setter/getter 方法,我们更新 age 并获取值,并直接更新 name。

In this example, we’ve created a class with a private variable age and a variable with default scope as name. Using setter/getter method, we’re updating age and getting value and name is updated directly.

public class Puppy {
   private int age;
   String name;

   public Puppy() {
   }

   public void setAge( int age ) {
      this.age = age;
   }

   public int getAge( ) {
      return age;
   }

   public static void main(String []args) {
      Puppy myPuppy = new Puppy();

      // update age variable using method call
      myPuppy.setAge( 2 );

      // update name directly
      myPuppy.name = "Tommy";
      System.out.println("Age: " + myPuppy.getAge() +", name: " + myPuppy.name );
   }
}

Output

Age: 2, name: Tommy

Java - Inheritance

继承可以定义为一个类获取另一个类的属性(方法和字段)的过程。通过使用继承,可以以层次结构的方式管理信息。

Inheritance can be defined as the process where one class acquires the properties (methods and fields) of another. With the use of inheritance the information is made manageable in a hierarchical order.

继承其他类属性的类称为子类(派生类、子类),而其属性被继承的类称为超类(基类、父类)。

The class which inherits the properties of other is known as subclass (derived class, child class) and the class whose properties are inherited is known as superclass (base class, parent class).

extends Keyword

extends 是用于继承类属性的关键字。以下是 extends 关键字的语法。

extends is the keyword used to inherit the properties of a class. Following is the syntax of extends keyword.

Syntax

class Super {
   .....
   .....
}
class Sub extends Super {
   .....
   .....
}

Sample Code

以下是展示 Java 继承的示例。在此示例中,你可以观察到两个类,即 Calculation 和 My_Calculation。

Following is an example demonstrating Java inheritance. In this example, you can observe two classes namely Calculation and My_Calculation.

通过使用 extends 关键字,My_Calculation 从 Calculation 类继承 addition() 和 Subtraction() 方法。

Using extends keyword, the My_Calculation inherits the methods addition() and Subtraction() of Calculation class.

将以下程序复制并粘贴到一个名为 My_Calculation.java 的文件中:

Copy and paste the following program in a file with name My_Calculation.java

Example

class Calculation {
   int z;

   public void addition(int x, int y) {
      z = x + y;
      System.out.println("The sum of the given numbers:"+z);
   }

   public void Subtraction(int x, int y) {
      z = x - y;
      System.out.println("The difference between the given numbers:"+z);
   }
}

public class My_Calculation extends Calculation {
   public void multiplication(int x, int y) {
      z = x * y;
      System.out.println("The product of the given numbers:"+z);
   }

   public static void main(String args[]) {
      int a = 20, b = 10;
      My_Calculation demo = new My_Calculation();
      demo.addition(a, b);
      demo.Subtraction(a, b);
      demo.multiplication(a, b);
   }
}

按如下所示编译并执行上述代码。

Compile and execute the above code as shown below.

javac My_Calculation.java
java My_Calculation

执行程序后,它将生成以下结果 -

After executing the program, it will produce the following result −

Output

The sum of the given numbers:30
The difference between the given numbers:10
The product of the given numbers:200

在给定的程序中,当创建 My_Calculation 类的对象时,超类的内容的副本在其内部生成。这就是为什么,使用子类的对象可以访问超类的成员的原因。

In the given program, when an object to My_Calculation class is created, a copy of the contents of the superclass is made within it. That is why, using the object of the subclass you can access the members of a superclass.

inheritance

超类引用变量可以保存子类对象,但是仅使用该变量,你可以访问超类的成员,因此为了访问两个类的成员,建议始终为子类创建引用变量。

The Superclass reference variable can hold the subclass object, but using that variable you can access only the members of the superclass, so to access the members of both classes it is recommended to always create reference variable to the subclass.

如果你考虑上述程序,你可以按如下所示实例化类。但是使用超类引用变量(在这种情况下为 cal),你不能调用属于子类 My_Calculation 的方法 multiplication()

If you consider the above program, you can instantiate the class as given below. But using the superclass reference variable ( cal in this case) you cannot call the method multiplication(), which belongs to the subclass My_Calculation.

Calculation demo = new My_Calculation();
demo.addition(a, b);
demo.Subtraction(a, b);

Note - 子类会从超类中继承所有成员(字段、方法和嵌套类)。构造函数不是成员,因此不会被子类继承,但可以从子类调用超类的构造函数。

Note − A subclass inherits all the members (fields, methods, and nested classes) from its superclass. Constructors are not members, so they are not inherited by subclasses, but the constructor of the superclass can be invoked from the subclass.

The super keyword

super 关键字类似于 this 关键字。以下是使用 super 关键字的场景。

The super keyword is similar to this keyword. Following are the scenarios where the super keyword is used.

  1. It is used to differentiate the members of superclass from the members of subclass, if they have same names.

  2. It is used to invoke the superclass constructor from subclass.

Differentiating the Members

如果一个类正在继承另一个类的属性。并且如果超类的成员与子类的名称相同,则使用 super 关键字区分这些变量,如下所示。

If a class is inheriting the properties of another class. And if the members of the superclass have the names same as the sub class, to differentiate these variables we use super keyword as shown below.

super.variable
super.method();

Sample Code

本节提供了一个演示了 super 关键字用法的程序。

This section provides you a program that demonstrates the usage of the super keyword.

在给定的程序中,你有两个类,即 Sub_class 和 Super_class,它们都具有一个名为 display() 的方法(具有不同的实现)以及一个具有不同值的变量名为 num。我们正在调用两个类的 display() 方法并打印两个类的 num 变量的值。此处你可以观察到,我们使用了 super 关键字以将超类的成员与子类区分开来。

In the given program, you have two classes namely Sub_class and Super_class, both have a method named display() with different implementations, and a variable named num with different values. We are invoking display() method of both classes and printing the value of the variable num of both classes. Here you can observe that we have used super keyword to differentiate the members of superclass from subclass.

将程序复制并粘贴到名为 Sub_class.java 的文件中。

Copy and paste the program in a file with name Sub_class.java.

Example

class Super_class {
   int num = 20;

   // display method of superclass
   public void display() {
      System.out.println("This is the display method of superclass");
   }
}

public class Sub_class extends Super_class {
   int num = 10;

   // display method of sub class
   public void display() {
      System.out.println("This is the display method of subclass");
   }

   public void my_method() {
      // Instantiating subclass
      Sub_class sub = new Sub_class();

      // Invoking the display() method of sub class
      sub.display();

      // Invoking the display() method of superclass
      super.display();

      // printing the value of variable num of subclass
      System.out.println("value of the variable named num in sub class:"+ sub.num);

      // printing the value of variable num of superclass
      System.out.println("value of the variable named num in super class:"+ super.num);
   }

   public static void main(String args[]) {
      Sub_class obj = new Sub_class();
      obj.my_method();
   }
}

使用以下语法编译并执行上述代码。

Compile and execute the above code using the following syntax.

javac Super_Demo
java Super

执行程序后,你将获得以下结果 -

On executing the program, you will get the following result −

Output

This is the display method of subclass
This is the display method of superclass
value of the variable named num in sub class:10
value of the variable named num in super class:20

Invoking Superclass Constructor

如果一个类正在继承另一个类的属性,则子类会自动获得超类的默认构造函数。但是如果你希望调用超类的参数化构造函数,则需要使用 super 关键字,如下所示。

If a class is inheriting the properties of another class, the subclass automatically acquires the default constructor of the superclass. But if you want to call a parameterized constructor of the superclass, you need to use the super keyword as shown below.

super(values);

Sample Code

本节中给出的程序演示了如何使用 super 关键字调用超类的参数化构造函数。该程序包含一个超类和一个子类,其中超类包含一个接受整数值的参数化构造函数,且我们使用 super 关键字调用超类的参数化构造函数。

The program given in this section demonstrates how to use the super keyword to invoke the parametrized constructor of the superclass. This program contains a superclass and a subclass, where the superclass contains a parameterized constructor which accepts a integer value, and we used the super keyword to invoke the parameterized constructor of the superclass.

将以下程序复制并粘贴到名为 Subclass.java 的文件中

Copy and paste the following program in a file with the name Subclass.java

Example

class Superclass {
   int age;

   Superclass(int age) {
      this.age = age;
   }

   public void getAge() {
      System.out.println("The value of the variable named age in super class is: " +age);
   }
}

public class Subclass extends Superclass {
   Subclass(int age) {
      super(age);
   }

   public static void main(String args[]) {
      Subclass s = new Subclass(24);
      s.getAge();
   }
}

使用以下语法编译并执行上述代码。

Compile and execute the above code using the following syntax.

javac Subclass
java Subclass

Output

The value of the variable named age in super class is: 24

IS-A Relationship

IS-A 是一种表示方式:此对象是该对象的一种类型。让我们看看 extends 关键字如何用于实现继承。

IS-A is a way of saying: This object is a type of that object. Let us see how the extends keyword is used to achieve inheritance.

public class Animal {
}

public class Mammal extends Animal {
}

public class Reptile extends Animal {
}

public class Dog extends Mammal {
}

现在,根据上述示例,按面向对象术语,以下为真 -

Now, based on the above example, in Object-Oriented terms, the following are true −

  1. Animal is the superclass of Mammal class.

  2. Animal is the superclass of Reptile class.

  3. Mammal and Reptile are subclasses of Animal class.

  4. Dog is the subclass of both Mammal and Animal classes.

现在,如果我们考虑 IS-A 关系,我们可以说 −

Now, if we consider the IS-A relationship, we can say −

  1. Mammal IS-A Animal

  2. Reptile IS-A Animal

  3. Dog IS-A Mammal

  4. Hence: Dog IS-A Animal as well

通过使用 extends 关键字,子类将能够继承超类的所有属性,除了超类的私有属性。

With the use of the extends keyword, the subclasses will be able to inherit all the properties of the superclass except for the private properties of the superclass.

我们可以使用 instance 运算符来确保哺乳动物实际上是动物。

We can assure that Mammal is actually an Animal with the use of the instance operator.

Example

class Animal {
}

class Mammal extends Animal {
}

class Reptile extends Animal {
}

public class Dog extends Mammal {

   public static void main(String args[]) {
      Animal a = new Animal();
      Mammal m = new Mammal();
      Dog d = new Dog();

      System.out.println(m instanceof Animal);
      System.out.println(d instanceof Mammal);
      System.out.println(d instanceof Animal);
   }
}

Output

true
true
true

由于我们对 extends 关键字有了很好的理解,让我们研究如何使用 implements 关键字来获取 IS-A 关系。

Since we have a good understanding of the extends keyword, let us look into how the implements keyword is used to get the IS-A relationship.

通常,implements 关键字用于类来继承接口的属性。类永远不能扩展接口。

Generally, the implements keyword is used with classes to inherit the properties of an interface. Interfaces can never be extended by a class.

Example

public interface Animal {
}

public class Mammal implements Animal {
}

public class Dog extends Mammal {
}

The instanceof Keyword

让我们使用 instanceof 运算符来检查确定哺乳动物是否实际上是动物,狗是否实际上是动物。

Let us use the instanceof operator to check determine whether Mammal is actually an Animal, and dog is actually an Animal.

Example

interface Animal{}
class Mammal implements Animal{}

public class Dog extends Mammal {

   public static void main(String args[]) {
      Mammal m = new Mammal();
      Dog d = new Dog();

      System.out.println(m instanceof Animal);
      System.out.println(d instanceof Mammal);
      System.out.println(d instanceof Animal);
   }
}

Output

true
true
true

HAS-A relationship

这些关系主要基于使用情况。这确定了某个类是否 HAS-A 某些事情。这种关系有助于减少代码冗余和错误。

These relationships are mainly based on the usage. This determines whether a certain class HAS-A certain thing. This relationship helps to reduce duplication of code as well as bugs.

让我们看一个例子 −

Lets look into an example −

Example

public class Vehicle{}
public class Speed{}

public class Van extends Vehicle {
   private Speed sp;
}

这表明类 Van HAS-A Speed。通过为 Speed 单独创建一个类,我们不必将属于 speed 的所有代码都放入 Van 类中,这使得可以在多个应用程序中重用 Speed 类。

This shows that class Van HAS-A Speed. By having a separate class for Speed, we do not have to put the entire code that belongs to speed inside the Van class, which makes it possible to reuse the Speed class in multiple applications.

在面向对象特性中,用户不需要操心由哪个对象来完成实际工作。要实现此点,Van 类对 Van 类用户隐藏实现细节。因此,基本上发生的事情是用户会要求 Van 类执行某个动作,而 Van 类会自己完成工作或要求另一个类执行此动作。

In Object-Oriented feature, the users do not need to bother about which object is doing the real work. To achieve this, the Van class hides the implementation details from the users of the Van class. So, basically what happens is the users would ask the Van class to do a certain action and the Van class will either do the work by itself or ask another class to perform the action.

Types of Inheritance

有各种类型的继承,如下所示。

There are various types of inheritance as demonstrated below.

types of inheritance

需要记住的一个非常重要的事实是,Java 不支持多重继承。这意味着一个类不能扩展多个类。因此以下是违法的 −

A very important fact to remember is that Java does not support multiple inheritance. This means that a class cannot extend more than one class. Therefore following is illegal −

Example

public class extends Animal, Mammal{}

然而,一个类可以实现一个或多个接口,这帮助 Java 摆脱了多重继承的不可能。

However, a class can implement one or more interfaces, which has helped Java get rid of the impossibility of multiple inheritance.

Java - Polymorphism

多态性是指对象具有多种形式的能力。OOP 中最常见的多态性用途是当父类引用用于引用子类对象时。

Polymorphism is the ability of an object to take on many forms. The most common use of polymorphism in OOP occurs when a parent class reference is used to refer to a child class object.

任何可以传递多个 IS-A 测试的 Java 对象都被认为是多态的。在 Java 中,所有 Java 对象都是多态的,因为任何对象都将通过它们自己的类型和类对象的 IS-A 测试。

Any Java object that can pass more than one IS-A test is considered to be polymorphic. In Java, all Java objects are polymorphic since any object will pass the IS-A test for their own type and for the class Object.

重要的是要知道访问对象的唯一可能方法是通过引用变量。引用变量只能是一种类型。声明后,引用变量的类型不能更改。

It is important to know that the only possible way to access an object is through a reference variable. A reference variable can be of only one type. Once declared, the type of a reference variable cannot be changed.

引用变量可以重新分配给其他对象,前提是它未被声明为 final。引用变量的类型将确定它可以在对象上调用哪些方法。

The reference variable can be reassigned to other objects provided that it is not declared final. The type of the reference variable would determine the methods that it can invoke on the object.

引用变量可以引用其声明类型的任何对象或其声明类型的任何子类型。引用变量可以被声明为类或接口类型。

A reference variable can refer to any object of its declared type or any subtype of its declared type. A reference variable can be declared as a class or interface type.

Example

我们来看一个示例。

Let us look at an example.

public interface Vegetarian{}
public class Animal{}
public class Deer extends Animal implements Vegetarian{}

现在,Deer 类被认为是多态的,因为它具有多重继承。以下是上述示例的 true 内容 −

Now, the Deer class is considered to be polymorphic since this has multiple inheritance. Following are true for the above examples −

  1. A Deer IS-A Animal

  2. A Deer IS-A Vegetarian

  3. A Deer IS-A Deer

  4. A Deer IS-A Object

当我们将引用变量事实应用于 Deer 对象引用时,以下声明是合法的 −

When we apply the reference variable facts to a Deer object reference, the following declarations are legal −

Example

Deer d = new Deer();
Animal a = d;
Vegetarian v = d;
Object o = d;

所有引用变量 d、a、v、o 都引用堆中同一个 Deer 对象。

All the reference variables d, a, v, o refer to the same Deer object in the heap.

Example

在此示例中,我们通过创建 Deer 对象并将相同的对象分配给超类或已实现接口的引用来展示上述概念。

In this example, we’re showcasing the above concept by creating the object of a Deer and assigning the same to the references of superclasses or implemented interface.

interface Vegetarian{}
class Animal{}
public class Deer extends Animal implements Vegetarian{
	public static void main(String[] args) {
		Deer d = new Deer();
		Animal a = d;
		Vegetarian v = d;
		Object o = d;

		System.out.println(d instanceof Deer);
		System.out.println(a instanceof Deer);
		System.out.println(v instanceof Deer);
		System.out.println(o instanceof Deer);
	}
}

Output

true
true
true
true

Virtual Methods

在本节中,我将向你展示 Java 中重写方法的行为如何允许你在设计类时利用多态性。

In this section, I will show you how the behavior of overridden methods in Java allows you to take advantage of polymorphism when designing your classes.

我们已经讨论了方法覆盖,子类可以在父类中覆盖方法。覆盖方法实质上隐藏在父类中,并且不会被调用,除非子类在覆盖方法中使用 super 关键字。

We already have discussed method overriding, where a child class can override a method in its parent. An overridden method is essentially hidden in the parent class, and is not invoked unless the child class uses the super keyword within the overriding method.

Example

/* File name : Employee.java */
public class Employee {
   private String name;
   private String address;
   private int number;

   public Employee(String name, String address, int number) {
      System.out.println("Constructing an Employee");
      this.name = name;
      this.address = address;
      this.number = number;
   }

   public void mailCheck() {
      System.out.println("Mailing a check to " + this.name + " " + this.address);
   }

   public String toString() {
      return name + " " + address + " " + number;
   }

   public String getName() {
      return name;
   }

   public String getAddress() {
      return address;
   }

   public void setAddress(String newAddress) {
      address = newAddress;
   }

   public int getNumber() {
      return number;
   }
}

现在,假设我们以如下方式扩展 Employee 类 -

Now suppose we extend Employee class as follows −

/* File name : Salary.java */
public class Salary extends Employee {
   private double salary; // Annual salary

   public Salary(String name, String address, int number, double salary) {
      super(name, address, number);
      setSalary(salary);
   }

   public void mailCheck() {
      System.out.println("Within mailCheck of Salary class ");
      System.out.println("Mailing check to " + getName()
      + " with salary " + salary);
   }

   public double getSalary() {
      return salary;
   }

   public void setSalary(double newSalary) {
      if(newSalary >= 0.0) {
         salary = newSalary;
      }
   }

   public double computePay() {
      System.out.println("Computing salary pay for " + getName());
      return salary/52;
   }
}

现在,仔细研究以下程序,并尝试确定其输出 -

Now, you study the following program carefully and try to determine its output −

/* File name : VirtualDemo.java */
public class VirtualDemo {

   public static void main(String [] args) {
      Salary s = new Salary("Mohd Mohtashim", "Ambehta, UP", 3, 3600.00);
      Employee e = new Salary("John Adams", "Boston, MA", 2, 2400.00);
      System.out.println("Call mailCheck using Salary reference --");
      s.mailCheck();
      System.out.println("\n Call mailCheck using Employee reference--");
      e.mailCheck();
   }
}

class Employee {
   private String name;
   private String address;
   private int number;

   public Employee(String name, String address, int number) {
      System.out.println("Constructing an Employee");
      this.name = name;
      this.address = address;
      this.number = number;
   }

   public void mailCheck() {
      System.out.println("Mailing a check to " + this.name + " " + this.address);
   }

   public String toString() {
      return name + " " + address + " " + number;
   }

   public String getName() {
      return name;
   }

   public String getAddress() {
      return address;
   }

   public void setAddress(String newAddress) {
      address = newAddress;
   }

   public int getNumber() {
      return number;
   }
}

class Salary extends Employee {
   private double salary; // Annual salary

   public Salary(String name, String address, int number, double salary) {
      super(name, address, number);
      setSalary(salary);
   }

   public void mailCheck() {
      System.out.println("Within mailCheck of Salary class ");
      System.out.println("Mailing check to " + getName()
      + " with salary " + salary);
   }

   public double getSalary() {
      return salary;
   }

   public void setSalary(double newSalary) {
      if(newSalary >= 0.0) {
         salary = newSalary;
      }
   }

   public double computePay() {
      System.out.println("Computing salary pay for " + getName());
      return salary/52;
   }
}

Output

Constructing an Employee
Constructing an Employee

Call mailCheck using Salary reference --
Within mailCheck of Salary class
Mailing check to Mohd Mohtashim with salary 3600.0

Call mailCheck using Employee reference--
Within mailCheck of Salary class
Mailing check to John Adams with salary 2400.0

在这里,我们实例化两个 Salary 对象。一个使用 Salary 引用 s,另一个使用 Employee 引用 e

Here, we instantiate two Salary objects. One using a Salary reference s, and the other using an Employee reference e.

在调用 s.mailCheck() 时,编译器在编译时在 Salary 类中看到 mailCheck(),而 JVM 在运行时在 Salary 类中调用 mailCheck()。

While invoking s.mailCheck(), the compiler sees mailCheck() in the Salary class at compile time, and the JVM invokes mailCheck() in the Salary class at run time.

e 上的 mailCheck() 有很大不同,因为 e 是 Employee 引用。当编译器看到 e.mailCheck() 时,编译器在 Employee 类中看到 mailCheck() 方法。

mailCheck() on e is quite different because e is an Employee reference. When the compiler sees e.mailCheck(), the compiler sees the mailCheck() method in the Employee class.

在这里,在编译时,编译器在 Employee 中使用 mailCheck() 验证此语句。然而,在运行时,JVM 在 Salary 类中调用 mailCheck()。

Here, at compile time, the compiler used mailCheck() in Employee to validate this statement. At run time, however, the JVM invokes mailCheck() in the Salary class.

此行为称为虚拟方法调用,并且这些方法称为虚拟方法。无论编译时在源代码中使用的引用是什么数据类型,覆盖方法都在运行时被调用。

This behavior is referred to as virtual method invocation, and these methods are referred to as virtual methods. An overridden method is invoked at run time, no matter what data type the reference is that was used in the source code at compile time.

Java - Overriding

在上一章中,我们讨论了超类和子类。如果一个类从其超类继承了一个方法,那么就有机会覆盖该方法,前提是它没有被标记为 final。

In the previous chapter, we talked about superclasses and subclasses. If a class inherits a method from its superclass, then there is a chance to override the method provided that it is not marked final.

重写的优点是:能够定义特定于子类类型的一种行为,这意味着子类可以根据其需求实现父类方法。

The benefit of overriding is: ability to define a behavior that’s specific to the subclass type, which means a subclass can implement a parent class method based on its requirement.

以面向对象的方式来说,重写是指覆盖现有方法的功能。

In object-oriented terms, overriding means to override the functionality of an existing method.

Example

我们来看一个示例。

Let us look at an example.

class Animal {
   public void move() {
      System.out.println("Animals can move");
   }
}

class Dog extends Animal {
   public void move() {
      System.out.println("Dogs can walk and run");
   }
}

public class TestDog {

   public static void main(String args[]) {
      Animal a = new Animal();   // Animal reference and object
      Animal b = new Dog();   // Animal reference but Dog object

      a.move();   // runs the method in Animal class
      b.move();   // runs the method in Dog class
   }
}

Output

Animals can move
Dogs can walk and run

在上面的示例中,尽管 b 是 Animal 的一种类型,但它运行 Dog 类中的 move 方法。这样做的原因是:在编译时,针对引用类型进行检查。然而,在运行时,JVM 找出对象类型,并运行属于该特定对象的该方法。

In the above example, you can see that even though b is a type of Animal it runs the move method in the Dog class. The reason for this is: In compile time, the check is made on the reference type. However, in the runtime, JVM figures out the object type and would run the method that belongs to that particular object.

因此,在上面的示例中,程序将正确编译,因为 Animal 类具有 move 方法。然后,在运行时,运行特定于该对象的方法。

Therefore, in the above example, the program will compile properly since Animal class has the method move. Then, at the runtime, it runs the method specific for that object.

考虑以下示例 −

Consider the following example −

Example

class Animal {
   public void move() {
      System.out.println("Animals can move");
   }
}

class Dog extends Animal {
   public void move() {
      System.out.println("Dogs can walk and run");
   }
   public void bark() {
      System.out.println("Dogs can bark");
   }
}

public class TestDog {

   public static void main(String args[]) {
      Animal a = new Animal();   // Animal reference and object
      Animal b = new Dog();   // Animal reference but Dog object

      a.move();   // runs the method in Animal class
      b.move();   // runs the method in Dog class
      b.bark();
   }
}

Output

TestDog.java:26: error: cannot find symbol
      b.bark();
       ^
  symbol:   method bark()
  location: variable b of type Animal
1 error

此程序将抛出编译时错误,因为 b 的引用类型 Animal 没有任何名为 bark 的方法。

This program will throw a compile time error since b’s reference type Animal doesn’t have a method by the name of bark.

Rules for Method Overriding

  1. The argument list should be exactly the same as that of the overridden method.

  2. The return type should be the same or a subtype of the return type declared in the original overridden method in the superclass.

  3. The access level cannot be more restrictive than the overridden method’s access level. For example: If the superclass method is declared public then the overridding method in the sub class cannot be either private or protected.

  4. Instance methods can be overridden only if they are inherited by the subclass.

  5. A method declared final cannot be overridden.

  6. A method declared static cannot be overridden but can be re-declared.

  7. If a method cannot be inherited, then it cannot be overridden.

  8. A subclass within the same package as the instance’s superclass can override any superclass method that is not declared private or final.

  9. A subclass in a different package can only override the non-final methods declared public or protected.

  10. An overriding method can throw any uncheck exceptions, regardless of whether the overridden method throws exceptions or not. However, the overriding method should not throw checked exceptions that are new or broader than the ones declared by the overridden method. The overriding method can throw narrower or fewer exceptions than the overridden method.

  11. Constructors cannot be overridden.

Using the super Keyword

当调用一个被覆盖方法的超类版本时,使用 super 关键字。

When invoking a superclass version of an overridden method the super keyword is used.

Example

class Animal {
   public void move() {
      System.out.println("Animals can move");
   }
}

class Dog extends Animal {
   public void move() {
      super.move();   // invokes the super class method
      System.out.println("Dogs can walk and run");
   }
}

public class TestDog {

   public static void main(String args[]) {
      Animal b = new Dog();   // Animal reference but Dog object
      b.move();   // runs the method in Dog class
   }
}

Output

Animals can move
Dogs can walk and run

Java - Abstraction

如同字典所述,abstraction 是处理思想而非事件的质量。例如,在考虑电子邮件时,一些复杂的细节会对用户隐藏,例如发送电子邮件会发生什么、电子邮件服务器使用什么协议。因此,要发送电子邮件,您只需要键入内容、指出收件人的地址并单击发送。

As per dictionary, abstraction is the quality of dealing with ideas rather than events. For example, when you consider the case of e-mail, complex details such as what happens as soon as you send an e-mail, the protocol your e-mail server uses are hidden from the user. Therefore, to send an e-mail you just need to type the content, mention the address of the receiver, and click send.

同样,在面向对象编程中,抽象是向用户隐藏实现细节的过程,只向用户提供功能。换句话说,用户将获得对象做什么的信息,而不是它如何做。

Likewise in Object-oriented programming, abstraction is a process of hiding the implementation details from the user, only the functionality will be provided to the user. In other words, the user will have the information on what the object does instead of how it does it.

在 Java 中,抽象是使用抽象类和接口实现的。

In Java, abstraction is achieved using Abstract classes and interfaces.

Abstract Class

在声明中包含 abstract 关键字的类称为抽象类。

A class which contains the abstract keyword in its declaration is known as abstract class.

  1. Abstract classes may or may not contain abstract methods, i.e., methods without body ( public void get(); )

  2. But, if a class has at least one abstract method, then the class must be declared abstract.

  3. If a class is declared abstract, it cannot be instantiated.

  4. To use an abstract class, you have to inherit it from another class, provide implementations to the abstract methods in it.

  5. If you inherit an abstract class, you have to provide implementations to all the abstract methods in it.

Example

本节为您提供抽象类的示例。要创建一个抽象类,只需在类声明中,类关键字之前使用 abstract 关键字。

This section provides you an example of the abstract class. To create an abstract class, just use the abstract keyword before the class keyword, in the class declaration.

/* File name : Employee.java */
public abstract class Employee {
   private String name;
   private String address;
   private int number;

   public Employee(String name, String address, int number) {
      System.out.println("Constructing an Employee");
      this.name = name;
      this.address = address;
      this.number = number;
   }

   public double computePay() {
     System.out.println("Inside Employee computePay");
     return 0.0;
   }

   public void mailCheck() {
      System.out.println("Mailing a check to " + this.name + " " + this.address);
   }

   public String toString() {
      return name + " " + address + " " + number;
   }

   public String getName() {
      return name;
   }

   public String getAddress() {
      return address;
   }

   public void setAddress(String newAddress) {
      address = newAddress;
   }

   public int getNumber() {
      return number;
   }
}

您可以观察到,除了抽象方法外,Employee 类与 Java 中的普通类是相同的。该类现在是抽象类,但它仍然有三个字段、七个方法和一个构造器。

You can observe that except abstract methods the Employee class is same as normal class in Java. The class is now abstract, but it still has three fields, seven methods, and one constructor.

现在您可以尝试使用以下方法实例化 Employee 类 −

Now you can try to instantiate the Employee class in the following way −

/* File name : AbstractDemo.java */
public class AbstractDemo {

   public static void main(String [] args) {
      /* Following is not allowed and would raise error */
      Employee e = new Employee("George W.", "Houston, TX", 43);
      System.out.println("\n Call mailCheck using Employee reference--");
      e.mailCheck();
   }
}

abstract class Employee {
   private String name;
   private String address;
   private int number;

   public Employee(String name, String address, int number) {
      System.out.println("Constructing an Employee");
      this.name = name;
      this.address = address;
      this.number = number;
   }

   public double computePay() {
     System.out.println("Inside Employee computePay");
     return 0.0;
   }

   public void mailCheck() {
      System.out.println("Mailing a check to " + this.name + " " + this.address);
   }

   public String toString() {
      return name + " " + address + " " + number;
   }

   public String getName() {
      return name;
   }

   public String getAddress() {
      return address;
   }

   public void setAddress(String newAddress) {
      address = newAddress;
   }

   public int getNumber() {
      return number;
   }
}

当您编译上述类时,它会向您显示以下错误 −

When you compile the above class, it gives you the following error −

Employee.java:46: Employee is abstract; cannot be instantiated
      Employee e = new Employee("George W.", "Houston, TX", 43);
                   ^
1 error

Inheriting the Abstract Class

我们可以按照具体类中一样继承 Employee 类的属性,按照以下方法操作 −

We can inherit the properties of Employee class just like concrete class in the following way −

Example

/* File name : Salary.java */
public class Salary extends Employee {
   private double salary;   // Annual salary

   public Salary(String name, String address, int number, double salary) {
      super(name, address, number);
      setSalary(salary);
   }

   public void mailCheck() {
      System.out.println("Within mailCheck of Salary class ");
      System.out.println("Mailing check to " + getName() + " with salary " + salary);
   }

   public double getSalary() {
      return salary;
   }

   public void setSalary(double newSalary) {
      if(newSalary >= 0.0) {
         salary = newSalary;
      }
   }

   public double computePay() {
      System.out.println("Computing salary pay for " + getName());
      return salary/52;
   }
}

此处,您不能实例化 Employee 类,但您可以实例化 Salary 类,并使用该实例访问 Employee 类中的所有三个字段和七个方法,如下所示。

Here, you cannot instantiate the Employee class, but you can instantiate the Salary Class, and using this instance you can access all the three fields and seven methods of Employee class as shown below.

/* File name : AbstractDemo.java */
public class AbstractDemo {

   public static void main(String [] args) {
      Salary s = new Salary("Mohd Mohtashim", "Ambehta, UP", 3, 3600.00);
      Employee e = new Salary("John Adams", "Boston, MA", 2, 2400.00);
      System.out.println("Call mailCheck using Salary reference --");
      s.mailCheck();
      System.out.println("\n Call mailCheck using Employee reference--");
      e.mailCheck();
   }
}
abstract class Employee {
   private String name;
   private String address;
   private int number;

   public Employee(String name, String address, int number) {
      System.out.println("Constructing an Employee");
      this.name = name;
      this.address = address;
      this.number = number;
   }

   public double computePay() {
     System.out.println("Inside Employee computePay");
     return 0.0;
   }

   public void mailCheck() {
      System.out.println("Mailing a check to " + this.name + " " + this.address);
   }

   public String toString() {
      return name + " " + address + " " + number;
   }

   public String getName() {
      return name;
   }

   public String getAddress() {
      return address;
   }

   public void setAddress(String newAddress) {
      address = newAddress;
   }

   public int getNumber() {
      return number;
   }
}
class Salary extends Employee {
   private double salary;   // Annual salary

   public Salary(String name, String address, int number, double salary) {
      super(name, address, number);
      setSalary(salary);
   }

   public void mailCheck() {
      System.out.println("Within mailCheck of Salary class ");
      System.out.println("Mailing check to " + getName() + " with salary " + salary);
   }

   public double getSalary() {
      return salary;
   }

   public void setSalary(double newSalary) {
      if(newSalary >= 0.0) {
         salary = newSalary;
      }
   }

   public double computePay() {
      System.out.println("Computing salary pay for " + getName());
      return salary/52;
   }
}

Output

Constructing an Employee
Constructing an Employee
Call mailCheck using Salary reference --
Within mailCheck of Salary class
Mailing check to Mohd Mohtashim with salary 3600.0

 Call mailCheck using Employee reference--
Within mailCheck of Salary class
Mailing check to John Adams with salary 2400.0

Abstract Methods

如果希望一个类包含一个特定方法,但希望该方法的实际实现由子类确定,则可以在父类中将该方法声明为抽象。

If you want a class to contain a particular method but you want the actual implementation of that method to be determined by child classes, you can declare the method in the parent class as an abstract.

  1. abstract keyword is used to declare the method as abstract.

  2. You have to place the abstract keyword before the method name in the method declaration.

  3. An abstract method contains a method signature, but no method body.

  4. Instead of curly braces, an abstract method will have a semoi colon (;) at the end.

以下是抽象方法示例。

Following is an example of the abstract method.

Example

public abstract class Employee {
   private String name;
   private String address;
   private int number;

   public abstract double computePay();
   // Remainder of class definition
}

将方法声明为抽象方法会产生两个后果 −

Declaring a method as abstract has two consequences −

  1. The class containing it must be declared as abstract.

  2. Any class inheriting the current class must either override the abstract method or declare itself as abstract.

− 最终,派生类必须实现抽象方法;否则,您将拥有一个无法实例化的抽象类的层次结构。

Note − Eventually, a descendant class has to implement the abstract method; otherwise, you would have a hierarchy of abstract classes that cannot be instantiated.

假设 Salary 类继承 Employee 类,那么它应该实现以下所示的 computePay() 方法:

Suppose Salary class inherits the Employee class, then it should implement the computePay() method as shown below −

/* File name : Salary.java */
public class Salary extends Employee {
   private double salary;   // Annual salary

   public double computePay() {
      System.out.println("Computing salary pay for " + getName());
      return salary/52;
   }
   // Remainder of class definition
}

Example

以下示例展示了抽象方法的概念。

Following example showcases the concept of abstract method.

/* File name : AbstractDemo.java */
public class AbstractDemo {
   public static void main(String [] args) {
      Salary s = new Salary("Mohd Mohtashim", "Ambehta, UP", 3, 3600.00);
      System.out.println("salary: " + s.computePay());
   }
}
abstract class Employee {
   private String name;
   private String address;
   private int number;

   public Employee(String name, String address, int number) {
      System.out.println("Constructing an Employee");
      this.name = name;
      this.address = address;
      this.number = number;
   }

   public abstract double computePay();
      // Remainder of class definition

   public String getName() {
      return name;
   }

   public void setName(String name) {
      this.name = name;
   }

   public String getAddress() {
      return address;
   }

   public void setAddress(String address) {
      this.address = address;
   }

   public int getNumber() {
      return number;
   }

   public void setNumber(int number) {
      this.number = number;
   }
}
class Salary extends Employee {
   private double salary;   // Annual salary

   public Salary(String name, String address, int number, double salary) {
      super(name, address, number);
      this.salary = salary;
   }

   public double computePay() {
      System.out.println("Computing salary pay for " + getName());
      return salary/52;
   }
   // Remainder of class definition
}

Output

Constructing an Employee
Computing salary pay for Mohd Mohtashim
salary: 69.23076923076923

Java - Encapsulation

Encapsulation 是面向对象编程的四个基本概念之一。其他三个是继承、多态和抽象。

Encapsulation is one of the four fundamental OOP concepts. The other three are inheritance, polymorphism, and abstraction.

Java 中的封装是一种将数据(变量)和作用于数据(方法)的代码作为一个个元包装起来的机制。在封装中,类的变量将对其他类隐藏,只能通过它们当前类的方法进行访问。因此,它也被称为 data hiding

Encapsulation in Java is a mechanism of wrapping the data (variables) and code acting on the data (methods) together as a single unit. In encapsulation, the variables of a class will be hidden from other classes, and can be accessed only through the methods of their current class. Therefore, it is also known as data hiding.

若要在 Java 中实现封装:

To achieve encapsulation in Java −

  1. Declare the variables of a class as private.

  2. Provide public setter and getter methods to modify and view the variables values.

Example

以下示例演示如何在 Java 中实现封装:

Following is an example that demonstrates how to achieve Encapsulation in Java −

/* File name : EncapTest.java */
public class EncapTest {
   private String name;
   private String idNum;
   private int age;

   public int getAge() {
      return age;
   }

   public String getName() {
      return name;
   }

   public String getIdNum() {
      return idNum;
   }

   public void setAge( int newAge) {
      age = newAge;
   }

   public void setName(String newName) {
      name = newName;
   }

   public void setIdNum( String newId) {
      idNum = newId;
   }
}

公有 setXXX() 和 getXXX() 方法是 EncapTest 类实例变量的访问点。通常,这些方法称为取值器和设置器。因此,要访问变量的任何类都应该通过这些取值器和设置器进行访问。

The public setXXX() and getXXX() methods are the access points of the instance variables of the EncapTest class. Normally, these methods are referred as getters and setters. Therefore, any class that wants to access the variables should access them through these getters and setters.

可以使用以下程序访问 EncapTest 类的变量:

The variables of the EncapTest class can be accessed using the following program −

/* File name : RunEncap.java */
public class RunEncap {

   public static void main(String args[]) {
      EncapTest encap = new EncapTest();
      encap.setName("James");
      encap.setAge(20);
      encap.setIdNum("12343ms");

      System.out.print("Name : " + encap.getName() + " Age : " + encap.getAge());
   }
}

public class EncapTest {
   private String name;
   private String idNum;
   private int age;

   public int getAge() {
      return age;
   }

   public String getName() {
      return name;
   }

   public String getIdNum() {
      return idNum;
   }

   public void setAge( int newAge) {
      age = newAge;
   }

   public void setName(String newName) {
      name = newName;
   }

   public void setIdNum( String newId) {
      idNum = newId;
   }
}

Output

Name : James Age : 20

Benefits of Encapsulation

  1. The fields of a class can be made read-only or write-only.

  2. A class can have total control over what is stored in its fields.

Java - Interfaces

接口是 Java 中的引用类型。它类似于类。它是抽象方法的一个集合。类通过继承接口的抽象方法,实现一个接口。

An interface is a reference type in Java. It is similar to class. It is a collection of abstract methods. A class implements an interface, thereby inheriting the abstract methods of the interface.

除了抽象方法,一个接口还可能包含常量、默认方法、静态方法和嵌套类型。方法体只存在于默认方法和静态方法。

Along with abstract methods, an interface may also contain constants, default methods, static methods, and nested types. Method bodies exist only for default methods and static methods.

撰写接口类似于撰写类。但是,一个类描述了一个对象的属性和行为。而一个接口包含一个类实现的行为。

Writing an interface is similar to writing a class. But a class describes the attributes and behaviors of an object. And an interface contains behaviors that a class implements.

除非实现接口的类是抽象的,否则所有接口的方法都需要在类中定义。

Unless the class that implements the interface is abstract, all the methods of the interface need to be defined in the class.

接口在以下方面类似于类 -

An interface is similar to a class in the following ways −

  1. An interface can contain any number of methods.

  2. An interface is written in a file with a .java extension, with the name of the interface matching the name of the file.

  3. The byte code of an interface appears in a .class file.

  4. Interfaces appear in packages, and their corresponding bytecode file must be in a directory structure that matches the package name.

然而,接口在以下几个方面与类不同,包括 -

However, an interface is different from a class in several ways, including −

  1. You cannot instantiate an interface.

  2. An interface does not contain any constructors.

  3. All of the methods in an interface are abstract.

  4. An interface cannot contain instance fields. The only fields that can appear in an interface must be declared both static and final.

  5. An interface is not extended by a class; it is implemented by a class.

  6. An interface can extend multiple interfaces.

Declaring Interfaces

interface 关键字用于声明接口。以下是声明接口的一个简单示例 −

The interface keyword is used to declare an interface. Here is a simple example to declare an interface −

Example

以下是接口示例 −

Following is an example of an interface −

/* File name : NameOfInterface.java */
import java.lang.*;
// Any number of import statements

public interface NameOfInterface {
   // Any number of final, static fields
   // Any number of abstract method declarations\
}

接口具有以下属性 −

Interfaces have the following properties −

  1. An interface is implicitly abstract. You do not need to use the abstract keyword while declaring an interface.

  2. Each method in an interface is also implicitly abstract, so the abstract keyword is not needed.

  3. Methods in an interface are implicitly public.

Example

/* File name : Animal.java */
interface Animal {
   public void eat();
   public void travel();
}

Implementing Interfaces

当一个类实现一个接口时,可以将该类视为在签署一份合约,同意执行接口的特定行为。如果一个类没有执行接口的所有行为,则该类必须声明自身为抽象的。

When a class implements an interface, you can think of the class as signing a contract, agreeing to perform the specific behaviors of the interface. If a class does not perform all the behaviors of the interface, the class must declare itself as abstract.

类使用 implements 关键字来实现接口。implements 关键字出现在类声明中,紧跟声明的 extends 部分。

A class uses the implements keyword to implement an interface. The implements keyword appears in the class declaration following the extends portion of the declaration.

Example

/* File name : MammalInt.java */
public class MammalInt implements Animal {

   public void eat() {
      System.out.println("Mammal eats");
   }

   public void travel() {
      System.out.println("Mammal travels");
   }

   public int noOfLegs() {
      return 0;
   }

   public static void main(String args[]) {
      MammalInt m = new MammalInt();
      m.eat();
      m.travel();
   }
}
interface Animal {
   public void eat();
   public void travel();
}

Output

Mammal eats
Mammal travels

当覆盖接口中定义的方法时,需要遵循如下规则 -

When overriding methods defined in interfaces, there are several rules to be followed −

  1. Checked exceptions should not be declared on implementation methods other than the ones declared by the interface method or subclasses of those declared by the interface method.

  2. The signature of the interface method and the same return type or subtype should be maintained when overriding the methods.

  3. An implementation class itself can be abstract and if so, interface methods need not be implemented.

实现接口时,有以下几个规则 −

When implementation interfaces, there are several rules −

  1. A class can implement more than one interface at a time.

  2. A class can extend only one class, but implement many interfaces.

  3. An interface can extend another interface, in a similar way as a class can extend another class.

Extending Interfaces

接口可以扩展另一个接口,就像一个类可以扩展另一个类一样。*extends*关键字用于扩展接口,子接口继承父接口的方法。

An interface can extend another interface in the same way that a class can extend another class. The extends keyword is used to extend an interface, and the child interface inherits the methods of the parent interface.

以下的 Sports 接口被 Hockey 和 Football 接口扩展。

The following Sports interface is extended by Hockey and Football interfaces.

Example

// Filename: Sports.java
public interface Sports {
   public void setHomeTeam(String name);
   public void setVisitingTeam(String name);
}

// Filename: Football.java
public interface Football extends Sports {
   public void homeTeamScored(int points);
   public void visitingTeamScored(int points);
   public void endOfQuarter(int quarter);
}

// Filename: Hockey.java
public interface Hockey extends Sports {
   public void homeGoalScored();
   public void visitingGoalScored();
   public void endOfPeriod(int period);
   public void overtimePeriod(int ot);
}

Hockey 接口有四个方法,但它从 Sports 继承了两个方法;因此,实现 Hockey 的类需要实现所有六个方法。类似地,实现 Football 的类需要定义 Football 中的三个方法和 Sports 中的两个方法。

The Hockey interface has four methods, but it inherits two from Sports; thus, a class that implements Hockey needs to implement all six methods. Similarly, a class that implements Football needs to define the three methods from Football and the two methods from Sports.

Example

interface Sports {
   public void setHomeTeam(String name);
   public void setVisitingTeam(String name);
}

interface Football extends Sports {
   public void homeTeamScored(int points);
   public void visitingTeamScored(int points);
   public void endOfQuarter(int quarter);
}

interface Hockey extends Sports {
   public void homeGoalScored();
   public void visitingGoalScored();
   public void endOfPeriod(int period);
   public void overtimePeriod(int ot);
}

public class HockeyDemo implements Hockey {

   public void setHomeTeam(String name) {
      System.out.println("Home team: " + name);
   }

   public void setVisitingTeam(String name) {}

   public void homeGoalScored() {}

   public void visitingGoalScored() {}

   public void endOfPeriod(int period) {}

   public void overtimePeriod(int ot) {}

   public static void main(String[] args) {
      Hockey hockeyDemo = new HockeyDemo();
      hockeyDemo.setHomeTeam("India");
   }
}

Output

Home team: India

Extending Multiple Interfaces

Java 类只能扩展一个父类。不允许多重继承。但是,接口不是类,并且一个接口可以扩展多个父接口。

A Java class can only extend one parent class. Multiple inheritance is not allowed. Interfaces are not classes, however, and an interface can extend more than one parent interface.

extends 关键字只用一次,父接口在一个逗号分隔的列表中声明。

The extends keyword is used once, and the parent interfaces are declared in a comma-separated list.

例如,如果 Hockey 接口同时扩展 Sports 和 Event,它将被声明为 −

For example, if the Hockey interface extended both Sports and Event, it would be declared as −

Example

public interface Hockey extends Sports, Event
interface Sports {
   public void setHomeTeam(String name);
   public void setVisitingTeam(String name);
}

interface Football extends Sports {
   public void homeTeamScored(int points);
   public void visitingTeamScored(int points);
   public void endOfQuarter(int quarter);
}

interface Hockey extends Sports {
   public void homeGoalScored();
   public void visitingGoalScored();
   public void endOfPeriod(int period);
   public void overtimePeriod(int ot);
}

interface Event {
   public void organize();
}
public class HockeyDemo implements Hockey, Event {

   public void setHomeTeam(String name) {
      System.out.println("Home team: " + name);
   }

   public void setVisitingTeam(String name) {}

   public void homeGoalScored() {}

   public void visitingGoalScored() {}

   public void endOfPeriod(int period) {}

   public void overtimePeriod(int ot) {}

   public static void main(String[] args) {
      HockeyDemo hockeyDemo = new HockeyDemo();
      hockeyDemo.setHomeTeam("India");
      hockeyDemo.organize();
   }

   public void organize() {
      System.out.println("Match organized. ");
   }
}

Output

Home team: India
Match organized.

Tagging Interfaces

扩展接口最常见的用法是当父接口不包含任何方法时。例如,java.awt.event 包中的 MouseListenter 接口扩展了 java.util.EventListener,它被定义为 −

The most common use of extending interfaces occurs when the parent interface does not contain any methods. For example, the MouseListener interface in the java.awt.event package extended java.util.EventListener, which is defined as −

Example

package java.util;
public interface EventListener
{}

没有方法的接口被称为*tagging*接口。标记接口有两个基本设计目的 −

An interface with no methods in it is referred to as a tagging interface. There are two basic design purposes of tagging interfaces −

Creates a common parent − 与 EventListener 接口一样(Java API 中的其他数十个接口对其进行了扩展),您可以使用标记接口在接口组之间创建公共父接口。例如,当接口扩展 EventListener 时,JVM 知道该特定接口将在事件委托场景中使用。

Creates a common parent − As with the EventListener interface, which is extended by dozens of other interfaces in the Java API, you can use a tagging interface to create a common parent among a group of interfaces. For example, when an interface extends EventListener, the JVM knows that this particular interface is going to be used in an event delegation scenario.

Adds a data type to a class − 这是术语“标记”的由来。实现标记接口的类不需要定义任何方法(因为该接口没有任何方法),但该类通过多态性成为接口类型。

Adds a data type to a class − This situation is where the term, tagging comes from. A class that implements a tagging interface does not need to define any methods (since the interface does not have any), but the class becomes an interface type through polymorphism.

Java - Packages

在 Java 中使用包是为了防止命名冲突、控制访问、简化类、接口、枚举和注释的搜索/定位及使用等。

Packages are used in Java in order to prevent naming conflicts, to control access, to make searching/locating and usage of classes, interfaces, enumerations and annotations easier, etc.

一个 Package 可以被定义为相关类型的分组(类、接口、枚举和注解),提供访问保护并管理命名空间。

A Package can be defined as a grouping of related types (classes, interfaces, enumerations and annotations ) providing access protection and namespace management.

Java 中一些现存的包有:

Some of the existing packages in Java are −

  1. java.lang − bundles the fundamental classes

  2. java.io − classes for input , output functions are bundled in this package

程序员可以定义自己的包来捆绑类的组/接口等。将您实现的相关类分组是一个不错的方法,这样程序员可以轻易地确定类、接口、枚举和注解的相关性。

Programmers can define their own packages to bundle group of classes/interfaces, etc. It is a good practice to group related classes implemented by you so that a programmer can easily determine that the classes, interfaces, enumerations, and annotations are related.

由于包创建了一个新的名称空间,因此不会与其他包中的名称发生名称冲突。使用包,可以更轻松地提供访问控制,也可以更轻松地找到相关类。

Since the package creates a new namespace there won’t be any name conflicts with names in other packages. Using packages, it is easier to provide access control and it is also easier to locate the related classes.

Creating a Package

创建包时,你应当为包选择一个名称,并在包中想要包含的类、接口、枚举和注解类型的每个源文件的顶部包含一条 package 语句。

While creating a package, you should choose a name for the package and include a package statement along with that name at the top of every source file that contains the classes, interfaces, enumerations, and annotation types that you want to include in the package.

包语句应当是源文件中的第一行。每个源文件中只能有一个包语句,它适用于文件中的所有类型。

The package statement should be the first line in the source file. There can be only one package statement in each source file, and it applies to all types in the file.

如果未使用包语句,则类、接口、枚举和注解类型将放置在当前默认包中。

If a package statement is not used then the class, interfaces, enumerations, and annotation types will be placed in the current default package.

若要编译带包语句的 Java 程序,你必须按如下所示使用 -d 选项。

To compile the Java programs with package statements, you have to use -d option as shown below.

javac -d Destination_folder file_name.java

然后在指定的目标位置创建一个带有给定包名称的文件夹,并将编译的类文件放置在该文件夹中。

Then a folder with the given package name is created in the specified destination, and the compiled class files will be placed in that folder.

Example

我们来看一个创建名为 animals 的包的示例。最好使用小写字母作为包的名称,以避免与类和接口的名称发生冲突。

Let us look at an example that creates a package called animals. It is a good practice to use names of packages with lower case letters to avoid any conflicts with the names of classes and interfaces.

以下包示例包含名为 animals 的接口:

Following package example contains interface named animals −

/* File name : Animal.java */
package animals;

interface Animal {
   public void eat();
   public void travel();
}

现在让我们在同一包 animals 中实现上述接口:

Now, let us implement the above interface in the same package animals −

package animals;
/* File name : MammalInt.java */

public class MammalInt implements Animal {

   public void eat() {
      System.out.println("Mammal eats");
   }

   public void travel() {
      System.out.println("Mammal travels");
   }

   public int noOfLegs() {
      return 0;
   }

   public static void main(String args[]) {
      MammalInt m = new MammalInt();
      m.eat();
      m.travel();
   }
}

interface Animal {
   public void eat();
   public void travel();
}

现在按如下所示编译 java 文件:

Now compile the java files as shown below −

$ javac -d . Animal.java
$ javac -d . MammalInt.java

现在在当前目录中将创建一个名称为 animals 的包/文件夹,并将这些类文件放置其中,如下所示。

Now a package/folder with the name animals will be created in the current directory and these class files will be placed in it as shown below.

packages

你可以在包中执行类文件并获取如下所示的结果。

You can execute the class file within the package and get the result as shown below.

Mammal eats
Mammal travels

The import Keyword

如果某个类想要使用同一包中的另一个类,则不必使用包名称。同一包中的类可在没有任何特殊语法的条件下找到彼此。

If a class wants to use another class in the same package, the package name need not be used. Classes in the same package find each other without any special syntax.

Example

在这里,名为 Boss 的一个类被添加到已包含 Employee 的 payroll 包中。然后 Boss 可引用 Employee 类,而无需使用 payroll 前缀,如下面的 Boss 类所示。

Here, a class named Boss is added to the payroll package that already contains Employee. The Boss can then refer to the Employee class without using the payroll prefix, as demonstrated by the following Boss class.

package payroll;
public class Boss {
   public void payEmployee(Employee e) {
      e.mailCheck();
   }
}

如果 Employee 类不在 payroll 包中会发生什么?现在 Boss 类必须使用以下技巧之一来引用一个在另一个包中的类。

What happens if the Employee class is not in the payroll package? The Boss class must then use one of the following techniques for referring to a class in a different package.

  1. The fully qualified name of the class can be used. For example −

payroll.Employee
  1. The package can be imported using the import keyword and the wild card (*). For example −

import payroll.*;
  1. The class itself can be imported using the import keyword. For example −

import payroll.Employee;

Example

package payroll;

public class Employee {
   public void mailCheck() {
      System.out.println("Pay received.");
   }
}
package payroll;

import payroll.Employee;

public class Boss {
   public void payEmployee(Employee e) {
      e.mailCheck();
   }

   public static void main(String[] args) {
      Boss boss = new Boss();
	   Employee e = new Employee();
      boss.payEmployee(e);
   }
}

Output

Pay received.

Note − 一个类文件可包含任意数量的 import 语句。这些 import 语句必须出现在 package 语句之后并出现在类声明之前。

Note − A class file can contain any number of import statements. The import statements must appear after the package statement and before the class declaration.

The Directory Structure of Packages

将一个类放入一个包中时,会产生两个主要结果 −

Two major results occur when a class is placed in a package −

  1. The name of the package becomes a part of the name of the class, as we just discussed in the previous section.

  2. The name of the package must match the directory structure where the corresponding bytecode resides.

下面是一种管理你在 Java 中的文件的简单方法 −

Here is simple way of managing your files in Java −

将类的源代码、接口、枚举或注释类型放入一个文本文件中,其名称是该类型的简单名称,其扩展名为 .java

Put the source code for a class, interface, enumeration, or annotation type in a text file whose name is the simple name of the type and whose extension is .java.

例如 -

For example −

// File Name :  Car.java
package vehicle;

public class Car {
   // Class implementation.
}

现在,将该源文件放到一个目录中,其名称反映了该类所属的包的名称 −

Now, put the source file in a directory whose name reflects the name of the package to which the class belongs −

....\vehicle\Car.java

现在,限定类名和路径名如下 −

Now, the qualified class name and pathname would be as follows −

  1. Class name → vehicle.Car

  2. Path name → vehicle\Car.java (in windows)

通常情况下,一家公司会使用它反转的互联网域名作为其包名称。

In general, a company uses its reversed Internet domain name for its package names.

Example − 一家公司的互联网域名是 apple.com,那么它所有的包名称都将以 com.apple 开头。包名的每个部分对应于一个子目录。

Example − A company’s Internet domain name is apple.com, then all its package names would start with com.apple. Each component of the package name corresponds to a subdirectory.

Example − 该公司有一个 com.apple.computers 包,它包含一个 Dell.java 源文件,它会被包含在这个一系列的子目录中 −

Example − The company had a com.apple.computers package that contained a Dell.java source file, it would be contained in a series of subdirectories like this −

....\com\apple\computers\Dell.java

在编译时,编译器会为其中定义的每个类、接口和枚举创建一个独立的输出文件。该输出文件的基名是该类型的名称,而它的扩展名为 .class

At the time of compilation, the compiler creates a different output file for each class, interface and enumeration defined in it. The base name of the output file is the name of the type, and its extension is .class.

例如 -

For example −

// File Name: Dell.java
package com.apple.computers;

public class Dell {
}

class Ups {
}

现在,使用 -d 选项编译这个文件,如下 −

Now, compile this file as follows using -d option −

$javac -d . Dell.java

文件将按如下方式编译 −

The files will be compiled as follows −

.\com\apple\computers\Dell.class
.\com\apple\computers\Ups.class

你可以按如下方式导入在 \com\apple\computer\ 中定义的所有类或接口 −

You can import all the classes or interfaces defined in \com\apple\computers\ as follows −

import com.apple.computers.*;

与 .java 源文件类似,编译的 .class 文件应位于一系列反映包名的目录中。但是,通往 .class 文件的路径不必与通往 .java 源文件的路径相同。你可以单独排列你的源文件和类目录,如下 −

Like the .java source files, the compiled .class files should be in a series of directories that reflect the package name. However, the path to the .class files does not have to be the same as the path to the .java source files. You can arrange your source and class directories separately, as −

<path-one>\sources\com\apple\computers\Dell.java

<path-two>\classes\com\apple\computers\Dell.class

通过执行此操作,可以在不透露你的源代码的情况下,让其他程序员访问 classes 目录。你同样需要管理源代码和类文件,以便编译器和 Java 虚拟机 (JVM) 可以找到你的程序所使用的所有类型。

By doing this, it is possible to give access to the classes directory to other programmers without revealing your sources. You also need to manage source and class files in this manner so that the compiler and the Java Virtual Machine (JVM) can find all the types your program uses.

classes 目录的完整路径 <path-two>\classes 称为类路径,并使用 CLASSPATH 系统变量进行设置。编译器和 JVM 都通过向类路径中添加包名称,来构建到 .class 文件的路径。

The full path to the classes directory, <path-two>\classes, is called the class path, and is set with the CLASSPATH system variable. Both the compiler and the JVM construct the path to your .class files by adding the package name to the class path.

假设 <path-two>\classes 是类路径,并且包名称为 com.apple.computers,那么编译器和 JVM 会在 <path-two>\classes\com\apple\computers 中寻找 .class 文件。

Say <path-two>\classes is the class path, and the package name is com.apple.computers, then the compiler and JVM will look for .class files in <path-two>\classes\com\apple\computers.

一个类路径中可包含多个路径。多个路径应使用分号(Windows)或冒号(Unix)分隔。默认情况下,编译器和 JVM 会搜索当前目录和包含 Java 平台类的 JAR 文件,以便这些目录自动位于类路径中。

A class path may include several paths. Multiple paths should be separated by a semicolon (Windows) or colon (Unix). By default, the compiler and the JVM search the current directory and the JAR file containing the Java platform classes so that these directories are automatically in the class path.

Set CLASSPATH System Variable

要显示当前的 CLASSPATH 变量,请在 Windows 和 UNIX(Bourne shell)中使用以下命令:

To display the current CLASSPATH variable, use the following commands in Windows and UNIX (Bourne shell) −

  1. In Windows → C:&gt; set CLASSPATH

  2. In UNIX → % echo $CLASSPATH

要删除 CLASSPATH 变量的当前内容,请使用:

To delete the current contents of the CLASSPATH variable, use −

  1. In Windows → C:&gt; set CLASSPATH =

  2. In UNIX → % unset CLASSPATH; export CLASSPATH

要设置 CLASSPATH 变量,请使用:

To set the CLASSPATH variable −

  1. In Windows → set CLASSPATH = C:\users\jack\java\classes

  2. In UNIX → % CLASSPATH = /home/jack/java/classes; export CLASSPATH

Java - Inner classes

在本章中,我们将讨论 Java 的内部类。

In this chapter, we will discuss inner classes of Java.

Nested Classes

在 Java 中,就像方法一样,一个类的变量也可以将其另一个类作为自己的成员。在 Java 中允许在另一个类中编写类。在内部编写的这个类被称为 nested class,而持有内部类的这个类被称为 outer class

In Java, just like methods, variables of a class too can have another class as its member. Writing a class within another is allowed in Java. The class written within is called the nested class, and the class that holds the inner class is called the outer class.

Syntax

以下是要写一个嵌套类的语法。这里,类 Outer_Demo 是外部类,类 Inner_Demo 是嵌套类。

Following is the syntax to write a nested class. Here, the class Outer_Demo is the outer class and the class Inner_Demo is the nested class.

class Outer_Demo {
   class Inner_Demo {
   }
}

嵌套类分为两种 −

Nested classes are divided into two types −

  1. Non-static nested classes − These are the non-static members of a class.

  2. Static nested classes − These are the static members of a class.

inner classes

Inner Classes (Non-static Nested Classes)

内部类是 Java 中的一种安全机制。我们知道一个类不可与访问修饰符 private 相关联,但是如果我们把这个类作为另一个类的成员,那么这个内部类可以设为私有的。这亦用于访问一个类的私有成员。

Inner classes are a security mechanism in Java. We know a class cannot be associated with the access modifier private, but if we have the class as a member of other class, then the inner class can be made private. And this is also used to access the private members of a class.

根据定义它们的位置和方式,内部类有三种类型。它们是 −

Inner classes are of three types depending on how and where you define them. They are −

  1. Inner Class

  2. Method-local Inner Class

  3. Anonymous Inner Class

Inner Class

创建内部类很简单。你只需要在一个类中写一个类。与类不同,内部类可以是私有的,一旦你将内部类声明为私有的,则无法通过该类外部的对象访问。

Creating an inner class is quite simple. You just need to write a class within a class. Unlike a class, an inner class can be private and once you declare an inner class private, it cannot be accessed from an object outside the class.

以下是创建内部类并访问它的程序。在给定的示例中,我们将内部类设为私有,并通过一个方法来访问该类。

Following is the program to create an inner class and access it. In the given example, we make the inner class private and access the class through a method.

Example

class Outer_Demo {
   int num;

   // inner class
   private class Inner_Demo {
      public void print() {
         System.out.println("This is an inner class");
      }
   }

   // Accessing he inner class from the method within
   void display_Inner() {
      Inner_Demo inner = new Inner_Demo();
      inner.print();
   }
}

public class My_class {

   public static void main(String args[]) {
      // Instantiating the outer class
      Outer_Demo outer = new Outer_Demo();

      // Accessing the display_Inner() method.
      outer.display_Inner();
   }
}

在这里你可以看到 Outer_Demo 是外部类,Inner_Demo 是内部类,我们在这个方法中实例化内部类,并且从 main 方法调用此方法。

Here you can observe that Outer_Demo is the outer class, Inner_Demo is the inner class, display_Inner() is the method inside which we are instantiating the inner class, and this method is invoked from the main method.

如果您编译并执行上述程序,将得到以下结果 −

If you compile and execute the above program, you will get the following result −

Output

This is an inner class.

Accessing the Private Members

如前所述,内部类还用来访问类的私有成员。假设一个类有要访问它们的私有成员。在其中写一个内部类,从内部类中的一个方法(例如 getValue())中返回私有成员,最后从另一个类(你要从中访问私有成员的类)调用内部类的 getValue() 方法。

As mentioned earlier, inner classes are also used to access the private members of a class. Suppose, a class is having private members to access them. Write an inner class in it, return the private members from a method within the inner class, say, getValue(), and finally from another class (from which you want to access the private members) call the getValue() method of the inner class.

要实例化内部类,首先必须实例化外部类。此后,使用外部类的对象,以下是实例化内部类的方法。

To instantiate the inner class, initially you have to instantiate the outer class. Thereafter, using the object of the outer class, following is the way in which you can instantiate the inner class.

Outer_Demo outer = new Outer_Demo();
Outer_Demo.Inner_Demo inner = outer.new Inner_Demo();

以下程序显示如何使用内部类访问类的私有成员。

The following program shows how to access the private members of a class using inner class.

Example

class Outer_Demo {
   // private variable of the outer class
   private int num = 175;

   // inner class
   public class Inner_Demo {
      public int getNum() {
         System.out.println("This is the getnum method of the inner class");
         return num;
      }
   }
}

public class My_class2 {

   public static void main(String args[]) {
      // Instantiating the outer class
      Outer_Demo outer = new Outer_Demo();

      // Instantiating the inner class
      Outer_Demo.Inner_Demo inner = outer.new Inner_Demo();
      System.out.println(inner.getNum());
   }
}

如果您编译并执行上述程序,将得到以下结果 −

If you compile and execute the above program, you will get the following result −

Output

This is the getnum method of the inner class: 175

Method-local Inner Class

在 Java 中,我们可以在一个方法中写一个类,它将成为一个局部类型。与局部变量一样,内部类的范围限制在方法内。

In Java, we can write a class within a method and this will be a local type. Like local variables, the scope of the inner class is restricted within the method.

方法局部内部类只能在定义内部类的方法中实例化。以下程序演示如何使用方法局部内部类。

A method-local inner class can be instantiated only within the method where the inner class is defined. The following program shows how to use a method-local inner class.

Example

public class Outerclass {
   // instance method of the outer class
   void my_Method() {
      int num = 23;

      // method-local inner class
      class MethodInner_Demo {
         public void print() {
            System.out.println("This is method inner class "+num);
         }
      } // end of inner class

      // Accessing the inner class
      MethodInner_Demo inner = new MethodInner_Demo();
      inner.print();
   }

   public static void main(String args[]) {
      Outerclass outer = new Outerclass();
      outer.my_Method();
   }
}

如果您编译并执行上述程序,将得到以下结果 −

If you compile and execute the above program, you will get the following result −

Output

This is method inner class 23

Anonymous Inner Class

未声明类名的内部类称为 anonymous inner class。对于匿名内部类,我们同时声明和实例化它们。通常,每当你需要重写类或接口的方法时,它们就会被使用。匿名内部类的语法如下 −

An inner class declared without a class name is known as an anonymous inner class. In case of anonymous inner classes, we declare and instantiate them at the same time. Generally, they are used whenever you need to override the method of a class or an interface. The syntax of an anonymous inner class is as follows −

Syntax

AnonymousInner an_inner = new AnonymousInner() {
   public void my_method() {
      ........
      ........
   }
};

以下程序演示如何使用匿名内部类重写类的类。

The following program shows how to override the method of a class using anonymous inner class.

Example

abstract class AnonymousInner {
   public abstract void mymethod();
}

public class Outer_class {

   public static void main(String args[]) {
      AnonymousInner inner = new AnonymousInner() {
         public void mymethod() {
            System.out.println("This is an example of anonymous inner class");
         }
      };
      inner.mymethod();
   }
}

如果您编译并执行上述程序,将得到以下结果 −

If you compile and execute the above program, you will get the following result −

Output

This is an example of anonymous inner class

同样,你也可以使用匿名内部类重写具体类和接口的方法。

In the same way, you can override the methods of the concrete class as well as the interface using an anonymous inner class.

Anonymous Inner Class as Argument

通常,如果一个方法接受接口、抽象类或具体类的对象,那么我们可以实现接口、扩展抽象类,并将对象传给方法。如果它是一个类,那么我们可以直接将它传给方法。

Generally, if a method accepts an object of an interface, an abstract class, or a concrete class, then we can implement the interface, extend the abstract class, and pass the object to the method. If it is a class, then we can directly pass it to the method.

但在所有这三种情况下,你都可以将匿名内部类传给方法。以下是将匿名内部类作为方法参数传递的语法 −

But in all the three cases, you can pass an anonymous inner class to the method. Here is the syntax of passing an anonymous inner class as a method argument −

obj.my_Method(new My_Class() {
   public void Do() {
      .....
      .....
   }
});

以下程序演示如何将匿名内部类作为方法参数传递。

The following program shows how to pass an anonymous inner class as a method argument.

Example

// interface
interface Message {
   String greet();
}

public class My_class {
   // method which accepts the object of interface Message
   public void displayMessage(Message m) {
      System.out.println(m.greet() +
         ", This is an example of anonymous inner class as an argument");
   }

   public static void main(String args[]) {
      // Instantiating the class
      My_class obj = new My_class();

      // Passing an anonymous inner class as an argument
      obj.displayMessage(new Message() {
         public String greet() {
            return "Hello";
         }
      });
   }
}

如果您编译并执行上面的程序,您将获得以下结果-

If you compile and execute the above program, it gives you the following result −

Output

Hello, This is an example of anonymous inner class as an argument

Static Nested Class

静态内部类是一个嵌套类,它是外部类的静态成员。可以使用其他静态成员在不实例化外部类的情况下访问它。与静态成员一样,静态嵌套类无权访问外部类的实例变量和方法。静态嵌套类的语法如下-

A static inner class is a nested class which is a static member of the outer class. It can be accessed without instantiating the outer class, using other static members. Just like static members, a static nested class does not have access to the instance variables and methods of the outer class. The syntax of static nested class is as follows −

Syntax

class MyOuter {
   static class Nested_Demo {
   }
}

实例化一个静态嵌套类与实例化一个内部类略有不同。以下程序演示了如何使用静态嵌套类。

Instantiating a static nested class is a bit different from instantiating an inner class. The following program shows how to use a static nested class.

Example

public class Outer {
   static class Nested_Demo {
      public void my_method() {
         System.out.println("This is my nested class");
      }
   }

   public static void main(String args[]) {
      Outer.Nested_Demo nested = new Outer.Nested_Demo();
      nested.my_method();
   }
}

如果您编译并执行上述程序,将得到以下结果 −

If you compile and execute the above program, you will get the following result −

Output

This is my nested class

Java - Character Class

通常,当我们处理字符时,我们使用原始数据类型char。

Normally, when we work with characters, we use primitive data types char.

Example

char ch = 'a';

// Unicode for uppercase Greek omega character
char uniChar = '\u039A';

// an array of chars
char[] charArray ={ 'a', 'b', 'c', 'd', 'e' };

然而在开发中,我们会遇到需要使用对象来代替原始数据类型的情况。为了实现这一点,Java为原始数据类型char提供了包装类`@ {s0}`。

However in development, we come across situations where we need to use objects instead of primitive data types. In order to achieve this, Java provides wrapper class Character for primitive data type char.

`Character`类提供了一些有用的类(即静态)方法来操作字符。你可以使用`Character`构造函数创建一个`Character`对象 -

The Character class offers a number of useful class (i.e., static) methods for manipulating characters. You can create a Character object with the Character constructor −

Character ch = new Character('a');

在某些情况下,Java编译器还会为你创建一个`Character`对象。例如,如果你将一个原始char传递给一个期望对象的函数,编译器会自动为你将char转换成一个`Character`。此功能称为自动装箱或拆箱,如果转换相反。

The Java compiler will also create a Character object for you under some circumstances. For example, if you pass a primitive char into a method that expects an object, the compiler automatically converts the char to a Character for you. This feature is called autoboxing or unboxing, if the conversion goes the other way.

Example

// Here following primitive char 'a'
// is boxed into the Character object ch
Character ch = 'a';

// Here primitive 'x' is boxed for method test,
// return is unboxed to char 'c'
char c = test('x');

Escape Sequences

一个带有反斜杠(\)的前缀字符是一个转义序列,并且对编译器有特殊的含义。

A character preceded by a backslash (\) is an escape sequence and has a special meaning to the compiler.

换行符(\n)在本教程中经常在`System.out.println()`语句中使用,以便在字符串打印后换到下一行。

The newline character (\n) has been used frequently in this tutorial in System.out.println() statements to advance to the next line after the string is printed.

下表显示了Java转义序列 -

Following table shows the Java escape sequences −

Escape Sequence

Description

\t

Inserts a tab in the text at this point.

\b

Inserts a backspace in the text at this point.

\n

Inserts a newline in the text at this point.

\r

Inserts a carriage return in the text at this point.

\f

Inserts a form feed in the text at this point.

\'

Inserts a single quote character in the text at this point.

\"

Inserts a double quote character in the text at this point.

当在打印语句中遇到转义序列时,编译器会相应地对其进行解释。

When an escape sequence is encountered in a print statement, the compiler interprets it accordingly.

Example

如果你想在引号内放入引号,则必须在内部引号上使用转义序列 \”,-

If you want to put quotes within quotes, you must use the escape sequence, \", on the interior quotes −

public class Test {

   public static void main(String args[]) {
      System.out.println("She said \"Hello!\" to me.");
   }
}

Output

She said "Hello!" to me.

Character Methods

以下是 Character 类的所有子类实现的重要实例化方法的列表 −

Following is the list of the important instance methods that all the subclasses of the Character class implement −

Sr.No.

Method & Description

1

isLetter() Determines whether the specified char value is a letter.

2

isDigit() Determines whether the specified char value is a digit.

3

isWhitespace() Determines whether the specified char value is white space.

4

isUpperCase() Determines whether the specified char value is uppercase.

5

isLowerCase() Determines whether the specified char value is lowercase.

6

toUpperCase() Returns the uppercase form of the specified char value.

7

toLowerCase() Returns the lowercase form of the specified char value.

8

toString() Returns a String object representing the specified character value that is, a one-character string.

有关方法的完整列表,请参阅 java.lang.Character API 规范。

For a complete list of methods, please refer to the java.lang.Character API specification.

What is Next?

在下一节中,我们将介绍 Java 中的 String 类。您将学习如何有效地声明和使用 String,以及 String 类中一些重要的方法。

In the next section, we will be going through the String class in Java. You will be learning how to declare and use Strings efficiently as well as some of the important methods in the String class.

Java - Files and I/O

java.io 包包含了你执行 Java 中的输入输出 (I/O) 所可能需要的几乎所有类。所有这些流都代表了一个输入源和一个输出目标。java.io 包中的流支持许多数据,比如基本类型、对象、本地化的字符等。

The java.io package contains nearly every class you might ever need to perform input and output (I/O) in Java. All these streams represent an input source and an output destination. The stream in the java.io package supports many data such as primitives, object, localized characters, etc.

Stream

流可以被定义为一个数据序列。流有两种:

A stream can be defined as a sequence of data. There are two kinds of Streams −

  1. InPutStream − The InputStream is used to read data from a source.

  2. OutPutStream − The OutputStream is used for writing data to a destination.

streams

Java 提供了对文件和网络的强大而灵活的 I/O 相关支持,但本教程涵盖了与流和 I/O 相关的非常基本的功能。我们一个一个地看最常用的例子:

Java provides strong but flexible support for I/O related to files and networks but this tutorial covers very basic functionality related to streams and I/O. We will see the most commonly used examples one by one −

Byte Streams

Java 字节流用于执行 8 位字节的输入和输出。虽然有许多与字节流相关的类,但最常用的类是 FileInputStreamFileOutputStream。下面是一个利用这两个类将一个输入文件复制到一个输出文件的示例:

Java byte streams are used to perform input and output of 8-bit bytes. Though there are many classes related to byte streams but the most frequently used classes are, FileInputStream and FileOutputStream. Following is an example which makes use of these two classes to copy an input file into an output file −

Example

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

public class CopyFile {

   public static void main(String args[]) throws IOException {
      FileInputStream in = null;
      FileOutputStream out = null;

      try {
         in = new FileInputStream("input.txt");
         out = new FileOutputStream("output.txt");

         int c;
         while ((c = in.read()) != -1) {
            out.write(c);
         }
      }finally {
         if (in != null) {
            in.close();
         }
         if (out != null) {
            out.close();
         }
      }
   }
}

现在,我们有一个文件 input.txt,其中包含以下内容:

Now let’s have a file input.txt with the following content −

This is test for copy file.

接下来,编译上述程序并执行它,这将导致创建一个内容与 input.txt 中相同的名为 output.txt 的文件。那么,我们将上述代码放入 CopyFile.java 文件中,并执行以下操作 −

As a next step, compile the above program and execute it, which will result in creating output.txt file with the same content as we have in input.txt. So let’s put the above code in CopyFile.java file and do the following −

$javac CopyFile.java
$java CopyFile

Character Streams

Java Byte 流用于执行 8 位字节的输入和输出,而 Java Character 流用于执行 16 位 Unicode 的输入和输出。虽然存在许多与字符流相关的类,但最常用的类是 FileReaderFileWriter。尽管 FileReader 在内部使用 FileInputStream,FileWriter 在内部使用 FileOutputStream,但这里的主要区别在于 FileReader 一次读取两个字节,而 FileWriter 一次写入两个字节。

Java Byte streams are used to perform input and output of 8-bit bytes, whereas Java Character streams are used to perform input and output for 16-bit unicode. Though there are many classes related to character streams but the most frequently used classes are, FileReader and FileWriter. Though internally FileReader uses FileInputStream and FileWriter uses FileOutputStream but here the major difference is that FileReader reads two bytes at a time and FileWriter writes two bytes at a time.

我们可重写上述示例,它利用这两个类将输入文件(包含 unicode 字符)复制到输出文件中 −

We can re-write the above example, which makes the use of these two classes to copy an input file (having unicode characters) into an output file −

Example

import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;

public class CopyFile {

   public static void main(String args[]) throws IOException {
      FileReader in = null;
      FileWriter out = null;

      try {
         in = new FileReader("input.txt");
         out = new FileWriter("output.txt");

         int c;
         while ((c = in.read()) != -1) {
            out.write(c);
         }
      }finally {
         if (in != null) {
            in.close();
         }
         if (out != null) {
            out.close();
         }
      }
   }
}

现在,我们有一个文件 input.txt,其中包含以下内容:

Now let’s have a file input.txt with the following content −

This is test for copy file.

接下来,编译上述程序并执行它,这将导致创建一个内容与 input.txt 中相同的名为 output.txt 的文件。那么,我们将上述代码放入 CopyFile.java 文件中,并执行以下操作 −

As a next step, compile the above program and execute it, which will result in creating output.txt file with the same content as we have in input.txt. So let’s put the above code in CopyFile.java file and do the following −

$javac CopyFile.java
$java CopyFile

Standard Streams

所有的编程语言都提供对标准 I/O 的支持,用户程序可从键盘获取输入,然后在计算机屏幕上生成输出。如果您知道 C 或 C++ 编程语言,那么您肯定知道三个标准设备 STDIN、STDOUT 和 STDERR。同样,Java 提供了以下三个标准流 −

All the programming languages provide support for standard I/O where the user’s program can take input from a keyboard and then produce an output on the computer screen. If you are aware of C or C++ programming languages, then you must be aware of three standard devices STDIN, STDOUT and STDERR. Similarly, Java provides the following three standard streams −

  1. Standard Input − This is used to feed the data to user’s program and usually a keyboard is used as standard input stream and represented as System.in.

  2. Standard Output − This is used to output the data produced by the user’s program and usually a computer screen is used for standard output stream and represented as System.out.

  3. Standard Error − This is used to output the error data produced by the user’s program and usually a computer screen is used for standard error stream and represented as System.err.

以下是一个简单的程序,它创建 InputStreamReader 以读取标准输入流,直到用户键入“q” −

Following is a simple program, which creates InputStreamReader to read standard input stream until the user types a "q" −

Example

import java.io.InputStreamReader;

public class ReadConsole {

   public static void main(String args[]) throws IOException {
      InputStreamReader cin = null;

      try {
         cin = new InputStreamReader(System.in);
         System.out.println("Enter characters, 'q' to quit.");
         char c;
         do {
            c = (char) cin.read();
            System.out.print(c);
         } while(c != 'q');
      }finally {
         if (cin != null) {
            cin.close();
         }
      }
   }
}

我们将上述代码保存在 ReadConsole.java 文件中,并尝试编译并执行它,如下面的程序所示。此程序将继续读取并输出相同的字符,直到我们按“q”为止 −

Let’s keep the above code in ReadConsole.java file and try to compile and execute it as shown in the following program. This program continues to read and output the same character until we press 'q' −

$javac ReadConsole.java
$java ReadConsole
Enter characters, 'q' to quit.
1
1
e
e
q
q

Reading and Writing Files

如前文所述,流可定义为数据序列。InputStream 用于从源读取数据,而 OutputStream 用于将数据写入目标。

As described earlier, a stream can be defined as a sequence of data. The InputStream is used to read data from a source and the OutputStream is used for writing data to a destination.

以下是对输入和输出流进行处理的类层次结构。

Here is a hierarchy of classes to deal with Input and Output streams.

file io

两个重要的流是 FileInputStreamFileOutputStream,本教程将对它们进行讨论。

The two important streams are FileInputStream and FileOutputStream, which would be discussed in this tutorial.

FileInputStream

此流用于从文件中读取数据。可以使用关键字 new 创建对象,并且有若干种构造函数可用。

This stream is used for reading data from the files. Objects can be created using the keyword new and there are several types of constructors available.

以下构造函数将文件名作为字符串以创建输入流对象来读取文件 −

Following constructor takes a file name as a string to create an input stream object to read the file −

InputStream f = new FileInputStream("C:/java/hello");

以下构造函数获取文件对象以创建输入流对象来读取文件。我们首先使用 File() 方法创建一个文件对象,如下所示 −

Following constructor takes a file object to create an input stream object to read the file. First we create a file object using File() method as follows −

File f = new File("C:/java/hello");
InputStream f = new FileInputStream(f);

一旦您掌握了 InputStream 对象,即可以使用一组辅助方法来读取流或对流执行其他操作。

Once you have InputStream object in hand, then there is a list of helper methods which can be used to read to stream or to do other operations on the stream.

Sr.No.

Method & Description

1

public void close() throws IOException{} This method closes the file output stream. Releases any system resources associated with the file. Throws an IOException.

2

protected void finalize()throws IOException {} This method cleans up the connection to the file. Ensures that the close method of this file output stream is called when there are no more references to this stream. Throws an IOException.

3

public int read(int r)throws IOException{} This method reads the specified byte of data from the InputStream. Returns an int. Returns the next byte of data and -1 will be returned if it’s the end of the file.

4

public int read(byte[] r) throws IOException{} This method reads r.length bytes from the input stream into an array. Returns the total number of bytes read. If it is the end of the file, -1 will be returned.

5

public int available() throws IOException{} Gives the number of bytes that can be read from this file input stream. Returns an int.

FileOutputStream

FileOutputStream 用于创建文件并将数据写入其中。流将在写入之前创建文件(如果尚未存在)。

FileOutputStream is used to create a file and write data into it. The stream would create a file, if it doesn’t already exist, before opening it for output.

下面有两个可用于创建 FileOutputStream 对象的构造函数。

Here are two constructors which can be used to create a FileOutputStream object.

下面的构造函数以字符串形式获取一个文件名,用于创建一个输入流对象以写入文件:

Following constructor takes a file name as a string to create an input stream object to write the file −

OutputStream f = new FileOutputStream("C:/java/hello")

下面的构造函数获取一个文件对象,用于创建一个输出流对象以写入文件。首先,我们使用 File() 方法创建一个文件对象,如下所示:

Following constructor takes a file object to create an output stream object to write the file. First, we create a file object using File() method as follows −

File f = new File("C:/java/hello");
OutputStream f = new FileOutputStream(f);

get OutputStream 对象后,可以使用一系列帮助方法将数据写入流或对流执行其他操作。

Once you have OutputStream object in hand, then there is a list of helper methods, which can be used to write to stream or to do other operations on the stream.

Sr.No.

Method & Description

1

public void close() throws IOException{} This method closes the file output stream. Releases any system resources associated with the file. Throws an IOException.

2

protected void finalize()throws IOException {} This method cleans up the connection to the file. Ensures that the close method of this file output stream is called when there are no more references to this stream. Throws an IOException.

3

public void write(int w)throws IOException{} This methods writes the specified byte to the output stream.

4

public void write(byte[] w) Writes w.length bytes from the mentioned byte array to the OutputStream.

Example

以下是演示 InputStream 和 OutputStream 的示例 −

Following is the example to demonstrate InputStream and OutputStream −

import java.io.OutputStream;

public class fileStreamTest {

   public static void main(String args[]) {

      try {
         byte bWrite [] = {11,21,3,40,5};
         OutputStream os = new FileOutputStream("test.txt");
         for(int x = 0; x < bWrite.length ; x++) {
            os.write( bWrite[x] );   // writes the bytes
         }
         os.close();

         InputStream is = new FileInputStream("test.txt");
         int size = is.available();

         for(int i = 0; i < size; i++) {
            System.out.print((char)is.read() + "  ");
         }
         is.close();
      } catch (IOException e) {
         System.out.print("Exception");
      }
   }
}

上述代码将创建文件 test.txt,并以二进制格式写入给定数字。stdout 屏幕上的输出也会相同。

The above code would create file test.txt and would write given numbers in binary format. Same would be the output on the stdout screen.

Directories in Java

目录是一个可以包含其他文件和目录列表的文件。使用 File 对象创建目录,以列出目录中可用的文件。有关完整详细信息,请查看可以在文件对象上调用的所有方法的列表以及与目录相关的方法。

A directory is a File which can contain a list of other files and directories. You use File object to create directories, to list down files available in a directory. For complete detail, check a list of all the methods which you can call on File object and what are related to directories.

Creating Directories

有两个有用的 File 实用方法可用于创建目录 −

There are two useful File utility methods, which can be used to create directories −

  1. The mkdir( ) method creates a directory, returning true on success and false on failure. Failure indicates that the path specified in the File object already exists, or that the directory cannot be created because the entire path does not exist yet.

  2. The mkdirs() method creates both a directory and all the parents of the directory.

以下示例创建 "/tmp/user/java/bin" 目录 −

Following example creates "/tmp/user/java/bin" directory −

Example

import java.io.File;

public class CreateDir {

   public static void main(String args[]) {
      String dirname = "/tmp/user/java/bin";
      File d = new File(dirname);

      // Create directory now.
      d.mkdirs();
   }
}

编译并执行上述代码以创建 "/tmp/user/java/bin"。

Compile and execute the above code to create "/tmp/user/java/bin".

Note − Java 会自动按照惯例处理 UNIX 和 Windows 上的路径分隔符。如果你在 Java 的 Windows 版本上使用正斜杠 (/),路径仍然会正确解析。

Note − Java automatically takes care of path separators on UNIX and Windows as per conventions. If you use a forward slash (/) on a Windows version of Java, the path will still resolve correctly.

Listing Directories

可以使用 File 对象提供的 list( ) 方法来列出目录中可用的所有文件和目录,如下所示 −

You can use list( ) method provided by File object to list down all the files and directories available in a directory as follows −

Example

import java.io.File;

public class ReadDir {

   public static void main(String[] args) {
      File file = null;
      String[] paths;

      try {
         // create new file object
         file = new File("/tmp");

         // array of files and directory
         paths = file.list();

         // for each name in the path array
         for(String path:paths) {
            // prints filename and directory name
            System.out.println(path);
         }
      } catch (Exception e) {
         // if any error occurs
         e.printStackTrace();
      }
   }
}

这将根据 /tmp 目录中可用的目录和文件生成以下结果 −

This will produce the following result based on the directories and files available in your /tmp directory −

Output

test1.txt
test2.txt
ReadDir.java
ReadDir.class

Java - Exceptions

异常(或特殊事件)是在程序执行期间产生的问题。当 Exception 发生时,程序的正常流程会中断,程序/应用程序异常终止,这是不建议的,因此,这些异常需要被处理。

An exception (or exceptional event) is a problem that arises during the execution of a program. When an Exception occurs the normal flow of the program is disrupted and the program/Application terminates abnormally, which is not recommended, therefore, these exceptions are to be handled.

异常可能由于许多不同的原因而发生。以下是一些发生异常的情况。

An exception can occur for many different reasons. Following are some scenarios where an exception occurs.

  1. A user has entered an invalid data.

  2. A file that needs to be opened cannot be found.

  3. A network connection has been lost in the middle of communications or the JVM has run out of memory.

其中一些异常是由用户错误引起的,另一些是由程序员错误引起的,还有一些是由某种方式失效的物理资源引起的。

Some of these exceptions are caused by user error, others by programmer error, and others by physical resources that have failed in some manner.

基于这些,我们有三大类的异常。您需要理解它们才能知道 Java 中的异常处理是如何工作的。

Based on these, we have three categories of Exceptions. You need to understand them to know how exception handling works in Java.

  1. Checked exceptions − A checked exception is an exception that is checked (notified) by the compiler at compilation-time, these are also called as compile time exceptions. These exceptions cannot simply be ignored, the programmer should take care of (handle) these exceptions.

例如,如果您在程序中使用 FileReader 类从文件中读取数据,如果其构造函数中指定的文件不存在,则会发生 FileNotFoundException,并且编译器会提示程序员处理该异常。

For example, if you use FileReader class in your program to read data from a file, if the file specified in its constructor doesn’t exist, then a FileNotFoundException occurs, and the compiler prompts the programmer to handle the exception.

Example

import java.io.File;
import java.io.FileReader;

public class FilenotFound_Demo {

   public static void main(String args[]) {
      File file = new File("E://file.txt");
      FileReader fr = new FileReader(file);
   }
}

如果您尝试编译上述程序,您将获得以下异常。

If you try to compile the above program, you will get the following exceptions.

Output

C:\>javac FilenotFound_Demo.java
FilenotFound_Demo.java:8: error: unreported exception FileNotFoundException; must be caught or declared to be thrown
      FileReader fr = new FileReader(file);
                      ^
1 error

Note − 由于 FileReader 类的 read()close() 方法会抛出 IOException,您可以观察到编译器通知处理 IOException,以及 FileNotFoundException。

Note − Since the methods read() and close() of FileReader class throws IOException, you can observe that the compiler notifies to handle IOException, along with FileNotFoundException.

  1. Unchecked exceptions − An unchecked exception is an exception that occurs at the time of execution. These are also called as Runtime Exceptions. These include programming bugs, such as logic errors or improper use of an API. Runtime exceptions are ignored at the time of compilation.

例如,如果您在程序中声明了一个长度为 5 的数组,并尝试调用该数组的第 6 个元素,则会发生 ArrayIndexOutOfBoundsException 异常。

For example, if you have declared an array of size 5 in your program, and trying to call the 6th element of the array then an ArrayIndexOutOfBoundsExceptionexception occurs.

Example

public class Unchecked_Demo {

   public static void main(String args[]) {
      int num[] = {1, 2, 3, 4};
      System.out.println(num[5]);
   }
}

如果您编译并执行上述程序,您将获得以下异常。

If you compile and execute the above program, you will get the following exception.

Output

Exception in thread "main" java.lang.ArrayIndexOutOfBoundsException: 5
	at Exceptions.Unchecked_Demo.main(Unchecked_Demo.java:8)
  1. Errors − These are not exceptions at all, but problems that arise beyond the control of the user or the programmer. Errors are typically ignored in your code because you can rarely do anything about an error. For example, if a stack overflow occurs, an error will arise. They are also ignored at the time of compilation.

Exception Hierarchy

所有异常类都是 java.lang.Exception 类的子类型。Exception 类是 Throwable 类的子类。除了 exception 类之外,还有另一个称为 Error 的子类,它派生自 Throwable 类。

All exception classes are subtypes of the java.lang.Exception class. The exception class is a subclass of the Throwable class. Other than the exception class there is another subclass called Error which is derived from the Throwable class.

错误是发生在严重故障的情况下的异常条件,这些错误不受 Java 程序处理。生成错误是为了指示由运行时环境生成的错误。示例:JVM 已用完内存。通常,程序无法从错误中恢复。

Errors are abnormal conditions that happen in case of severe failures, these are not handled by the Java programs. Errors are generated to indicate errors generated by the runtime environment. Example: JVM is out of memory. Normally, programs cannot recover from errors.

Exception 类有两个主要子类:IOException 类和 RuntimeException 类。

The Exception class has two main subclasses: IOException class and RuntimeException Class.

exceptions1

以下列出了最常见的 Java’s Built-in Exceptions检查项和未检查项。

Following is a list of most common checked and unchecked Java’s Built-in Exceptions.

Exceptions Methods

以下是 Throwable 类中提供的重要方法的列表。

Following is the list of important methods available in the Throwable class.

Sr.No.

Method & Description

1

public String getMessage() Returns a detailed message about the exception that has occurred. This message is initialized in the Throwable constructor.

2

public Throwable getCause() Returns the cause of the exception as represented by a Throwable object.

3

public String toString() Returns the name of the class concatenated with the result of getMessage().

4

public void printStackTrace() Prints the result of toString() along with the stack trace to System.err, the error output stream.

5

public StackTraceElement [] getStackTrace() Returns an array containing each element on the stack trace. The element at index 0 represents the top of the call stack, and the last element in the array represents the method at the bottom of the call stack.

6

public Throwable fillInStackTrace() Fills the stack trace of this Throwable object with the current stack trace, adding to any previous information in the stack trace.

Catching Exceptions

使用 trycatch 关键字组合的方法捕获异常。一个 try/catch 块被放置在可能生成异常的代码周围。try/catch 块内的代码被称为受保护代码,try/catch 使用的语法如下所示 −

A method catches an exception using a combination of the try and catch keywords. A try/catch block is placed around the code that might generate an exception. Code within a try/catch block is referred to as protected code, and the syntax for using try/catch looks like the following −

Syntax

try {
   // Protected code
} catch (ExceptionName e1) {
   // Catch block
}

容易产生异常的代码被放置在 try 块中。当异常发生时,该发生的异常由与它关联的 catch 块处理。每个 try 块应该紧接着一个 catch 块或 finally 块。

The code which is prone to exceptions is placed in the try block. When an exception occurs, that exception occurred is handled by catch block associated with it. Every try block should be immediately followed either by a catch block or finally block.

catch 语句涉及声明你试图捕获的异常类型。如果受保护代码中发生异常,则检查 try 之后的 catch 块(或块)。如果发生的异常类型被列在一个 catch 块中,则异常被传递到 catch 块中,就像一个参数被传递到一个方法参数中一样。

A catch statement involves declaring the type of exception you are trying to catch. If an exception occurs in protected code, the catch block (or blocks) that follows the try is checked. If the type of exception that occurred is listed in a catch block, the exception is passed to the catch block much as an argument is passed into a method parameter.

Example

在下面的示例中,一个数组被声明为带有 2 个元素。然后代码尝试访问数组的第 3 个元素,从而抛出一个异常。

In following example, an array is declared with 2 elements. Then the code tries to access the 3rd element of the array which throws an exception.

// File Name : ExcepTest.java
import java.io.*;

public class ExcepTest {

   public static void main(String args[]) {
      try {
         int a[] = new int[2];
         System.out.println("Access element three :" + a[3]);
      } catch (ArrayIndexOutOfBoundsException e) {
         System.out.println("Exception thrown  :" + e);
      }
      System.out.println("Out of the block");
   }
}

Output

Exception thrown  :java.lang.ArrayIndexOutOfBoundsException: 3
Out of the block

Multiple Catch Blocks

一个 try 块可以跟随多个 catch 块。多个 catch 块的语法如下所示 −

A try block can be followed by multiple catch blocks. The syntax for multiple catch blocks looks like the following −

Syntax

try {
   // Protected code
} catch (ExceptionType1 e1) {
   // Catch block
} catch (ExceptionType2 e2) {
   // Catch block
} catch (ExceptionType3 e3) {
   // Catch block
}

前面的语句演示了三个 catch 块,但是你可以在一个 try 之后可以有任意数量的 catch 块。如果受保护代码中发生异常,则异常被抛到列表中的第一个 catch 块。如果抛出的异常的数据类型匹配 ExceptionType1,则异常在该处被捕获。如果没有,则异常传递到第二个 catch 语句。这将持续到异常被捕获或者通过所有 catch,在这种情况下,当前方法停止执行并且异常被抛到调用堆栈上先前的那个方法。

The previous statements demonstrate three catch blocks, but you can have any number of them after a single try. If an exception occurs in the protected code, the exception is thrown to the first catch block in the list. If the data type of the exception thrown matches ExceptionType1, it gets caught there. If not, the exception passes down to the second catch statement. This continues until the exception either is caught or falls through all catches, in which case the current method stops execution and the exception is thrown down to the previous method on the call stack.

Example

这里有一个代码段显示如何使用多个 try/catch 语句。

Here is code segment showing how to use multiple try/catch statements.

try {
   file = new FileInputStream(fileName);
   x = (byte) file.read();
} catch (IOException i) {
   i.printStackTrace();
   return -1;
} catch (FileNotFoundException f) // Not valid! {
   f.printStackTrace();
   return -1;
}

Catching Multiple Type of Exceptions

自 Java 7 起,你可以使用一个 catch 块处理多个异常,这个功能简化了代码。以下是处理它的方法 −

Since Java 7, you can handle more than one exception using a single catch block, this feature simplifies the code. Here is how you would do it −

catch (IOException|FileNotFoundException ex) {
   logger.log(ex);
   throw ex;

The Throws/Throw Keywords

如果一个方法没有处理已检查异常,则方法必须使用 throws 关键字声明它。throws 关键字显示在方法签名的末尾。

If a method does not handle a checked exception, the method must declare it using the throws keyword. The throws keyword appears at the end of a method’s signature.

你可以使用 throw 关键字抛出一个异常,它既可以是一个新实例化的异常,也可以是你刚捕获的异常。

You can throw an exception, either a newly instantiated one or an exception that you just caught, by using the throw keyword.

尝试理解 throws 和 throw 关键字之间的差异,throws 用于推迟对已检查异常的处理,而 throw 用于显式地调用一个异常。

Try to understand the difference between throws and throw keywords, throws is used to postpone the handling of a checked exception and throw is used to invoke an exception explicitly.

以下方法声明它抛出一个 RemoteException −

The following method declares that it throws a RemoteException −

Example

import java.io.*;
public class className {

   public void deposit(double amount) throws RemoteException {
      // Method implementation
      throw new RemoteException();
   }
   // Remainder of class definition
}

一个方法可以声明它抛出多个异常,在这种情况下,异常被声明在一个以逗号分隔的列表中。例如,以下方法声明它抛出 RemoteException 和 InsufficientFundsException −

A method can declare that it throws more than one exception, in which case the exceptions are declared in a list separated by commas. For example, the following method declares that it throws a RemoteException and an InsufficientFundsException −

Example

import java.io.*;
public class className {

   public void withdraw(double amount) throws RemoteException,
      InsufficientFundsException {
      // Method implementation
   }
   // Remainder of class definition
}

The Finally Block

finally 块跟随一个 try 块或一个 catch 块。无论异常是否发生,finally 代码块始终执行。

The finally block follows a try block or a catch block. A finally block of code always executes, irrespective of occurrence of an Exception.

使用 finally 块允许你运行你想要执行的任何清理类型语句,无论受保护代码中发生什么。

Using a finally block allows you to run any cleanup-type statements that you want to execute, no matter what happens in the protected code.

finally 块出现在 catch 块的末尾并且具有以下语法 −

A finally block appears at the end of the catch blocks and has the following syntax −

Syntax

try {
   // Protected code
} catch (ExceptionType1 e1) {
   // Catch block
} catch (ExceptionType2 e2) {
   // Catch block
} catch (ExceptionType3 e3) {
   // Catch block
}finally {
   // The finally block always executes.
}

Example

public class ExcepTest {

   public static void main(String args[]) {
      int a[] = new int[2];
      try {
         System.out.println("Access element three :" + a[3]);
      } catch (ArrayIndexOutOfBoundsException e) {
         System.out.println("Exception thrown  :" + e);
      }finally {
         a[0] = 6;
         System.out.println("First element value: " + a[0]);
         System.out.println("The finally statement is executed");
      }
   }
}

Output

Exception thrown  :java.lang.ArrayIndexOutOfBoundsException: 3
First element value: 6
The finally statement is executed

注意以下内容 −

Note the following −

  1. A catch clause cannot exist without a try statement.

  2. It is not compulsory to have finally clauses whenever a try/catch block is present.

  3. The try block cannot be present without either catch clause or finally clause.

  4. Any code cannot be present in between the try, catch, finally blocks.

The try-with-resources

通常,当我们使用任何资源(例如流、连接等)时,我们必须使用 finally 块显式关闭它们。在以下程序中,我们正在使用 FileReader 从文件中读取数据,并且我们正在使用 finally 块关闭它。

Generally, when we use any resources like streams, connections, etc. we have to close them explicitly using finally block. In the following program, we are reading data from a file using FileReader and we are closing it using finally block.

Example

import java.io.File;
import java.io.FileReader;
import java.io.IOException;

public class ReadData_Demo {

   public static void main(String args[]) {
      FileReader fr = null;
      try {
         File file = new File("file.txt");
         fr = new FileReader(file); char [] a = new char[50];
         fr.read(a);   // reads the content to the array
         for(char c : a)
         System.out.print(c);   // prints the characters one by one
      } catch (IOException e) {
         e.printStackTrace();
      }finally {
         try {
            fr.close();
         } catch (IOException ex) {
            ex.printStackTrace();
         }
      }
   }
}

try-with-resources(也称为 automatic resource management)是 Java 7 引入的一种新的异常处理机制,它会自动关闭 try catch 块内使用的资源。

try-with-resources, also referred as automatic resource management, is a new exception handling mechanism that was introduced in Java 7, which automatically closes the resources used within the try catch block.

要使用此语句,您只需在括号中声明所需资源,创建的资源将在块结束时自动关闭。以下是 try-with-resources 语句的语法。

To use this statement, you simply need to declare the required resources within the parenthesis, and the created resource will be closed automatically at the end of the block. Following is the syntax of try-with-resources statement.

Syntax

try(FileReader fr = new FileReader("file path")) {
   // use the resource
   } catch () {
      // body of catch
   }
}

以下是使用 try-with-resources 语句读取文件中的数据的程序。

Following is the program that reads the data in a file using try-with-resources statement.

Example

import java.io.FileReader;
import java.io.IOException;

public class Try_withDemo {

   public static void main(String args[]) {
      try(FileReader fr = new FileReader("E://file.txt")) {
         char [] a = new char[50];
         fr.read(a);   // reads the contentto the array
         for(char c : a)
         System.out.print(c);   // prints the characters one by one
      } catch (IOException e) {
         e.printStackTrace();
      }
   }
}

在使用 try-with-resources 语句时,需要注意以下几点。

Following points are to be kept in mind while working with try-with-resources statement.

  1. To use a class with try-with-resources statement it should implement AutoCloseable interface and the close() method of it gets invoked automatically at runtime.

  2. You can declare more than one class in try-with-resources statement.

  3. While you declare multiple classes in the try block of try-with-resources statement these classes are closed in reverse order.

  4. Except the declaration of resources within the parenthesis everything is the same as normal try/catch block of a try block.

  5. The resource declared in try gets instantiated just before the start of the try-block.

  6. The resource declared at the try block is implicitly declared as final.

User-defined Exceptions

您可以在 Java 中创建自己的异常。在编写自己的异常类时,牢记以下几点:

You can create your own exceptions in Java. Keep the following points in mind when writing your own exception classes −

  1. All exceptions must be a child of Throwable.

  2. If you want to write a checked exception that is automatically enforced by the Handle or Declare Rule, you need to extend the Exception class.

  3. If you want to write a runtime exception, you need to extend the RuntimeException class.

我们可以按如下方式定义自己的 Exception 类:

We can define our own Exception class as below −

class MyException extends Exception {
}

您只需要扩展预定义的 Exception 类即可创建您自己的 Exception。这些被认为是已检查的异常。以下 InsufficientFundsException 类是一个用户定义的异常,它扩展了 Exception 类,使其成为一个已检查的异常。异常类就像任何其他类,包含有用的字段和方法。

You just need to extend the predefined Exception class to create your own Exception. These are considered to be checked exceptions. The following InsufficientFundsException class is a user-defined exception that extends the Exception class, making it a checked exception. An exception class is like any other class, containing useful fields and methods.

Example

// File Name InsufficientFundsException.java
import java.io.*;

public class InsufficientFundsException extends Exception {
   private double amount;

   public InsufficientFundsException(double amount) {
      this.amount = amount;
   }

   public double getAmount() {
      return amount;
   }
}

为了演示如何使用我们用户定义的异常,以下 CheckingAccount 类包含一个 withdraw() 方法,该方法会抛出一个 InsufficientFundsException。

To demonstrate using our user-defined exception, the following CheckingAccount class contains a withdraw() method that throws an InsufficientFundsException.

// File Name CheckingAccount.java
import java.io.*;

public class CheckingAccount {
   private double balance;
   private int number;

   public CheckingAccount(int number) {
      this.number = number;
   }

   public void deposit(double amount) {
      balance += amount;
   }

   public void withdraw(double amount) throws InsufficientFundsException {
      if(amount <= balance) {
         balance -= amount;
      }else {
         double needs = amount - balance;
         throw new InsufficientFundsException(needs);
      }
   }

   public double getBalance() {
      return balance;
   }

   public int getNumber() {
      return number;
   }
}

以下 BankDemo 程序演示如何调用 CheckingAccount 的 deposit() 和 withdraw() 方法。

The following BankDemo program demonstrates invoking the deposit() and withdraw() methods of CheckingAccount.

// File Name BankDemo.java
public class BankDemo {

   public static void main(String [] args) {
      CheckingAccount c = new CheckingAccount(101);
      System.out.println("Depositing $500...");
      c.deposit(500.00);

      try {
         System.out.println("\nWithdrawing $100...");
         c.withdraw(100.00);
         System.out.println("\nWithdrawing $600...");
         c.withdraw(600.00);
      } catch (InsufficientFundsException e) {
         System.out.println("Sorry, but you are short $" + e.getAmount());
         e.printStackTrace();
      }
   }
}

编译以上三个文件并运行 BankDemo。这将产生以下结果:

Compile all the above three files and run BankDemo. This will produce the following result −

Output

Depositing $500...

Withdrawing $100...

Withdrawing $600...
Sorry, but you are short $200.0
InsufficientFundsException
         at CheckingAccount.withdraw(CheckingAccount.java:25)
         at BankDemo.main(BankDemo.java:13)

Common Exceptions

在 Java 中,可以定义两类异常和错误。

In Java, it is possible to define two catergories of Exceptions and Errors.

  1. JVM Exceptions − These are exceptions/errors that are exclusively or logically thrown by the JVM. Examples: NullPointerException, ArrayIndexOutOfBoundsException, ClassCastException.

  2. Programmatic Exceptions − These exceptions are thrown explicitly by the application or the API programmers. Examples: IllegalArgumentException, IllegalStateException.

Java - Multithreading

Java 是一种多线程编程语言,这意味着我们可以使用 Java 开发多线程程序。多线程程序包含两个或更多可以同时运行的部分,每个部分都可以在同一时间处理不同的任务,从而优化利用可用资源,特别是在您的计算机有多个 CPU 时。

Java is a multi-threaded programming language which means we can develop multi-threaded program using Java. A multi-threaded program contains two or more parts that can run concurrently and each part can handle a different task at the same time making optimal use of the available resources specially when your computer has multiple CPUs.

根据定义,多任务处理是多个进程共享公共处理资源(如 CPU)时发生的情况。多线程将多任务处理的概念扩展到应用程序中,您可以在其中将单个应用程序内的特定操作细分为各个线程。每个线程都可以并行运行。操作系统不仅在不同应用程序之间划分处理时间,还在应用程序内的每个线程之间划分处理时间。

By definition, multitasking is when multiple processes share common processing resources such as a CPU. Multi-threading extends the idea of multitasking into applications where you can subdivide specific operations within a single application into individual threads. Each of the threads can run in parallel. The OS divides processing time not only among different applications, but also among each thread within an application.

通过使用多线程,您可以以在相同程序中可以并行执行多项活动的方式来编写代码。

Multi-threading enables you to write in a way where multiple activities can proceed concurrently in the same program.

Life Cycle of a Thread

线程在其生命周期中经过不同的阶段。例如,一个线程诞生、启动、运行,然后死亡。下图显示了线程的完整生命周期。

A thread goes through various stages in its life cycle. For example, a thread is born, started, runs, and then dies. The following diagram shows the complete life cycle of a thread.

thread life cycle

以下是生命周期的阶段 -

Following are the stages of the life cycle −

  1. New − A new thread begins its life cycle in the new state. It remains in this state until the program starts the thread. It is also referred to as a born thread.

  2. Runnable − After a newly born thread is started, the thread becomes runnable. A thread in this state is considered to be executing its task.

  3. Waiting − Sometimes, a thread transitions to the waiting state while the thread waits for another thread to perform a task. A thread transitions back to the runnable state only when another thread signals the waiting thread to continue executing.

  4. Timed Waiting − A runnable thread can enter the timed waiting state for a specified interval of time. A thread in this state transitions back to the runnable state when that time interval expires or when the event it is waiting for occurs.

  5. Terminated (Dead) − A runnable thread enters the terminated state when it completes its task or otherwise terminates.

Thread Priorities

每个 Java 线程都有一个优先级,这有助于操作系统确定线程调度的顺序。

Every Java thread has a priority that helps the operating system determine the order in which threads are scheduled.

Java 线程优先级介于 MIN_PRIORITY(常量为 1)和 MAX_PRIORITY(常量为 10)之间。默认情况下,每个线程都获得 NORM_PRIORITY(常量为 5)优先级。

Java thread priorities are in the range between MIN_PRIORITY (a constant of 1) and MAX_PRIORITY (a constant of 10). By default, every thread is given priority NORM_PRIORITY (a constant of 5).

具有较高优先级的线程对程序而言更为重要,并且应该在较低优先级的线程之前分配处理器时间。但是,线程优先级不能保证线程执行的顺序,并且很大程度上取决于平台。

Threads with higher priority are more important to a program and should be allocated processor time before lower-priority threads. However, thread priorities cannot guarantee the order in which threads execute and are very much platform dependent.

Create a Thread by Implementing a Runnable Interface

如果准备将您的类作为线程执行,那么可以通过实现 Runnable 接口实现此目的。您需要遵循三个基本步骤 −

If your class is intended to be executed as a thread then you can achieve this by implementing a Runnable interface. You will need to follow three basic steps −

Step 1

第一步,您需要实现 Runnable 接口提供的 run() 方法。此方法为线程提供了一个入口点,您需要将完整业务逻辑放入此方法内。以下是 run() 方法的一个简单语法:

As a first step, you need to implement a run() method provided by a Runnable interface. This method provides an entry point for the thread and you will put your complete business logic inside this method. Following is a simple syntax of the run() method −

public void run( )

Step 2

作为第二步,您将使用以下构造函数实例化一个 Thread 对象 −

As a second step, you will instantiate a Thread object using the following constructor −

Thread(Runnable threadObj, String threadName);

其中,threadObj 是实现 Runnable 接口的类的实例,threadName 是赋予新线程的名称。

Where, threadObj is an instance of a class that implements the Runnable interface and threadName is the name given to the new thread.

Step 3

一旦创建了 Thread 对象,就可以通过调用 start() 方法来启动它,它执行对 run( ) 方法的调用。以下是 start() 方法的简单语法 -

Once a Thread object is created, you can start it by calling start() method, which executes a call to run( ) method. Following is a simple syntax of start() method −

void start();

Example

下面是创建一个新线程并开始运行它的示例:

Here is an example that creates a new thread and starts running it −

class RunnableDemo implements Runnable {
   private Thread t;
   private String threadName;

   RunnableDemo( String name) {
      threadName = name;
      System.out.println("Creating " +  threadName );
   }

   public void run() {
      System.out.println("Running " +  threadName );
      try {
         for(int i = 4; i > 0; i--) {
            System.out.println("Thread: " + threadName + ", " + i);
            // Let the thread sleep for a while.
            Thread.sleep(50);
         }
      } catch (InterruptedException e) {
         System.out.println("Thread " +  threadName + " interrupted.");
      }
      System.out.println("Thread " +  threadName + " exiting.");
   }

   public void start () {
      System.out.println("Starting " +  threadName );
      if (t == null) {
         t = new Thread (this, threadName);
         t.start ();
      }
   }
}

public class TestThread {

   public static void main(String args[]) {
      RunnableDemo R1 = new RunnableDemo( "Thread-1");
      R1.start();

      RunnableDemo R2 = new RunnableDemo( "Thread-2");
      R2.start();
   }
}

Output

Creating Thread-1
Starting Thread-1
Creating Thread-2
Starting Thread-2
Running Thread-1
Thread: Thread-1, 4
Running Thread-2
Thread: Thread-2, 4
Thread: Thread-1, 3
Thread: Thread-2, 3
Thread: Thread-1, 2
Thread: Thread-2, 2
Thread: Thread-1, 1
Thread: Thread-2, 1
Thread Thread-1 exiting.
Thread Thread-2 exiting.

Create a Thread by Extending a Thread Class

创建线程的第二种方法是创建一个扩展 Thread 类的类,使用以下两个简单步骤。这种方法在使用 Thread 类中可用方法创建多个线程时提供了更多的灵活性。

The second way to create a thread is to create a new class that extends Thread class using the following two simple steps. This approach provides more flexibility in handling multiple threads created using available methods in Thread class.

Step 1

您需要覆盖 Thread 类中可用的 run( ) 方法。此方法为线程提供一个入口点,您将把您的完整业务逻辑放在这个方法中。以下是 run() 方法的简单语法:

You will need to override run( ) method available in Thread class. This method provides an entry point for the thread and you will put your complete business logic inside this method. Following is a simple syntax of run() method −

public void run( )

Step 2

一旦创建 Thread 对象,便可以通过调用 start() 方法来启动它,该调用会执行一个 run( ) 方法调用。以下是 start() 方法的一个简单语法 −

Once Thread object is created, you can start it by calling start() method, which executes a call to run( ) method. Following is a simple syntax of start() method −

void start( );

Example

以下是按照 Thread 扩展重写的先前程序:

Here is the preceding program rewritten to extend the Thread −

class ThreadDemo extends Thread {
   private Thread t;
   private String threadName;

   ThreadDemo( String name) {
      threadName = name;
      System.out.println("Creating " +  threadName );
   }

   public void run() {
      System.out.println("Running " +  threadName );
      try {
         for(int i = 4; i > 0; i--) {
            System.out.println("Thread: " + threadName + ", " + i);
            // Let the thread sleep for a while.
            Thread.sleep(50);
         }
      } catch (InterruptedException e) {
         System.out.println("Thread " +  threadName + " interrupted.");
      }
      System.out.println("Thread " +  threadName + " exiting.");
   }

   public void start () {
      System.out.println("Starting " +  threadName );
      if (t == null) {
         t = new Thread (this, threadName);
         t.start ();
      }
   }
}

public class TestThread {

   public static void main(String args[]) {
      ThreadDemo T1 = new ThreadDemo( "Thread-1");
      T1.start();

      ThreadDemo T2 = new ThreadDemo( "Thread-2");
      T2.start();
   }
}

Output

Creating Thread-1
Starting Thread-1
Creating Thread-2
Starting Thread-2
Running Thread-1
Thread: Thread-1, 4
Running Thread-2
Thread: Thread-2, 4
Thread: Thread-1, 3
Thread: Thread-2, 3
Thread: Thread-1, 2
Thread: Thread-2, 2
Thread: Thread-1, 1
Thread: Thread-2, 1
Thread Thread-1 exiting.
Thread Thread-2 exiting.

Thread Methods

以下是 Thread 类中提供的重要方法列表:

Following is the list of important methods available in the Thread class.

Sr.No.

Method & Description

1

public void start() Starts the thread in a separate path of execution, then invokes the run() method on this Thread object.

2

public void run() If this Thread object was instantiated using a separate Runnable target, the run() method is invoked on that Runnable object.

3

public final void setName(String name) Changes the name of the Thread object. There is also a getName() method for retrieving the name.

4

public final void setPriority(int priority) Sets the priority of this Thread object. The possible values are between 1 and 10.

5

public final void setDaemon(boolean on) A parameter of true denotes this Thread as a daemon thread.

6

public final void join(long millisec) The current thread invokes this method on a second thread, causing the current thread to block until the second thread terminates or the specified number of milliseconds passes.

7

public void interrupt() Interrupts this thread, causing it to continue execution if it was blocked for any reason.

8

public final boolean isAlive() Returns true if the thread is alive, which is any time after the thread has been started but before it runs to completion.

之前的方法都是在特定 Thread 对象上调用的。Thread 类中的以下方法是静态的。调用其中一个静态方法对当前运行的线程执行该操作。

The previous methods are invoked on a particular Thread object. The following methods in the Thread class are static. Invoking one of the static methods performs the operation on the currently running thread.

Sr.No.

Method & Description

1

public static void yield() Causes the currently running thread to yield to any other threads of the same priority that are waiting to be scheduled.

2

public static void sleep(long millisec) Causes the currently running thread to block for at least the specified number of milliseconds.

3

public static boolean holdsLock(Object x) Returns true if the current thread holds the lock on the given Object.

4

public static Thread currentThread() Returns a reference to the currently running thread, which is the thread that invokes this method.

5

public static void dumpStack() Prints the stack trace for the currently running thread, which is useful when debugging a multithreaded application.

Example

以下 ThreadClassDemo 程序演示了 Thread 类的其中一些方法。考虑一下 DisplayMessage 类,它实现了 Runnable

The following ThreadClassDemo program demonstrates some of these methods of the Thread class. Consider a class DisplayMessage which implements Runnable

// File Name : DisplayMessage.java
// Create a thread to implement Runnable

public class DisplayMessage implements Runnable {
   private String message;

   public DisplayMessage(String message) {
      this.message = message;
   }

   public void run() {
      while(true) {
         System.out.println(message);
      }
   }
}

以下是另一个扩展 Thread 类的类−

Following is another class which extends the Thread class −

// File Name : GuessANumber.java
// Create a thread to extentd Thread

public class GuessANumber extends Thread {
   private int number;
   public GuessANumber(int number) {
      this.number = number;
   }

   public void run() {
      int counter = 0;
      int guess = 0;
      do {
         guess = (int) (Math.random() * 100 + 1);
         System.out.println(this.getName() + " guesses " + guess);
         counter++;
      } while(guess != number);
      System.out.println("** Correct!" + this.getName() + "in" + counter + "guesses.**");
   }
}

以下是使用上述定义类的主程序−

Following is the main program, which makes use of the above-defined classes −

// File Name : ThreadClassDemo.java
public class ThreadClassDemo {

   public static void main(String [] args) {
      Runnable hello = new DisplayMessage("Hello");
      Thread thread1 = new Thread(hello);
      thread1.setDaemon(true);
      thread1.setName("hello");
      System.out.println("Starting hello thread...");
      thread1.start();

      Runnable bye = new DisplayMessage("Goodbye");
      Thread thread2 = new Thread(bye);
      thread2.setPriority(Thread.MIN_PRIORITY);
      thread2.setDaemon(true);
      System.out.println("Starting goodbye thread...");
      thread2.start();

      System.out.println("Starting thread3...");
      Thread thread3 = new GuessANumber(27);
      thread3.start();
      try {
         thread3.join();
      } catch (InterruptedException e) {
         System.out.println("Thread interrupted.");
      }
      System.out.println("Starting thread4...");
      Thread thread4 = new GuessANumber(75);

      thread4.start();
      System.out.println("main() is ending...");
   }
}
class DisplayMessage implements Runnable {
   private String message;

   public DisplayMessage(String message) {
      this.message = message;
   }

   public void run() {
      while(true) {
         System.out.println(message);
      }
   }
}
class GuessANumber extends Thread {
   private int number;
   public GuessANumber(int number) {
      this.number = number;
   }

   public void run() {
      int counter = 0;
      int guess = 0;
      do {
         guess = (int) (Math.random() * 100 + 1);
         System.out.println(this.getName() + " guesses " + guess);
         counter++;
      } while(guess != number);
      System.out.println("** Correct!" + this.getName() + "in" + counter + "guesses.**");
   }
}

Output

Starting hello thread...
Starting goodbye thread...
Hello
Hello
Hello
Hello
Hello
Hello
Goodbye
Goodbye
Goodbye
Goodbye
Goodbye
.......

Major Java Multithreading Concepts

在 Java 中进行多线程编程时,你需要非常熟练地掌握以下概念−

While doing Multithreading programming in Java, you would need to have the following concepts very handy −

Java - Thread Synchronization

当我们在程序中启动两个或更多线程时,可能会出现多种线程尝试访问相同资源的情况,最终它们由于并发问题而产生无法预料的结果。例如,如果多个线程尝试写入相同文件,则它们可能会破坏数据,因为其中一个线程可以覆盖数据,或者在一个线程打开相同文件的同时,另一个线程可能关闭相同文件。

When we start two or more threads within a program, there may be a situation when multiple threads try to access the same resource and finally they can produce unforeseen result due to concurrency issues. For example, if multiple threads try to write within a same file then they may corrupt the data because one of the threads can override data or while one thread is opening the same file at the same time another thread might be closing the same file.

因此,需要同步多个线程的动作并确保仅有一个线程可以在给定的时间点访问该资源。这是通过一个称为 monitors 的概念来实现的。Java 中的每个对象都与一个监视器关联,线程可以锁定或解锁该监视器。一次只能有一个线程持有对一个监视器的锁定。

So there is a need to synchronize the action of multiple threads and make sure that only one thread can access the resource at a given point in time. This is implemented using a concept called monitors. Each object in Java is associated with a monitor, which a thread can lock or unlock. Only one thread at a time may hold a lock on a monitor.

Java 编程语言提供了一种使用 synchronized 块创建线程并同步它们的 task 的非常便捷的方式。你将共享的资源保留在此块内。以下是同步语句的一般形式−

Java programming language provides a very handy way of creating threads and synchronizing their task by using synchronized blocks. You keep shared resources within this block. Following is the general form of the synchronized statement −

Syntax

synchronized(objectidentifier) {
   // Access shared variables and other shared resources
}

此处,objectidentifier 是对一个对象的引用,其锁与同步语句所表示的监视器相关联。现在,我们将看到两个示例,其中我们将使用两个不同的线程打印计数器。当线程不同步时,它们会打印不是按顺序的计数器值,但是当我们通过将代码放入 synchronized() 块内打印计数器时,则对于这两个线程都会非常顺序地打印计数器。

Here, the objectidentifier is a reference to an object whose lock associates with the monitor that the synchronized statement represents. Now we are going to see two examples, where we will print a counter using two different threads. When threads are not synchronized, they print counter value which is not in sequence, but when we print counter by putting inside synchronized() block, then it prints counter very much in sequence for both the threads.

Multithreading Example without Synchronization

这是一个简单的示例,它可能并不会按顺序打印 counter 的值,而且每次运行都会基于线程对 CPU 的可用性产生不同的结果。

Here is a simple example which may or may not print counter value in sequence and every time we run it, it produces a different result based on CPU availability to a thread.

Example

class PrintDemo {
   public void printCount() {
      try {
         for(int i = 5; i > 0; i--) {
            System.out.println("Counter   ---   "  + i );
         }
      } catch (Exception e) {
         System.out.println("Thread  interrupted.");
      }
   }
}

class ThreadDemo extends Thread {
   private Thread t;
   private String threadName;
   PrintDemo  PD;

   ThreadDemo( String name,  PrintDemo pd) {
      threadName = name;
      PD = pd;
   }

   public void run() {
      PD.printCount();
      System.out.println("Thread " +  threadName + " exiting.");
   }

   public void start () {
      System.out.println("Starting " +  threadName );
      if (t == null) {
         t = new Thread (this, threadName);
         t.start ();
      }
   }
}

public class TestThread {
   public static void main(String args[]) {

      PrintDemo PD = new PrintDemo();

      ThreadDemo T1 = new ThreadDemo( "Thread - 1 ", PD );
      ThreadDemo T2 = new ThreadDemo( "Thread - 2 ", PD );

      T1.start();
      T2.start();

      // wait for threads to end
         try {
         T1.join();
         T2.join();
      } catch ( Exception e) {
         System.out.println("Interrupted");
      }
   }
}

每次运行该程序都会产生不同的结果——

This produces a different result every time you run this program −

Output

Starting Thread - 1
Starting Thread - 2
Counter   ---   5
Counter   ---   4
Counter   ---   3
Counter   ---   5
Counter   ---   2
Counter   ---   1
Counter   ---   4
Thread Thread - 1  exiting.
Counter   ---   3
Counter   ---   2
Counter   ---   1
Thread Thread - 2  exiting.

Multithreading Example with Synchronization

这里有一个在序列中打印 counter 值的相同示例,我们每次运行它时,它都会产生相同的结果。

Here is the same example which prints counter value in sequence and every time we run it, it produces the same result.

Example

class PrintDemo {
   public void printCount() {
      try {
         for(int i = 5; i > 0; i--) {
            System.out.println("Counter   ---   "  + i );
         }
      } catch (Exception e) {
         System.out.println("Thread  interrupted.");
      }
   }
}

class ThreadDemo extends Thread {
   private Thread t;
   private String threadName;
   PrintDemo  PD;

   ThreadDemo( String name,  PrintDemo pd) {
      threadName = name;
      PD = pd;
   }

   public void run() {
      synchronized(PD) {
         PD.printCount();
      }
      System.out.println("Thread " +  threadName + " exiting.");
   }

   public void start () {
      System.out.println("Starting " +  threadName );
      if (t == null) {
         t = new Thread (this, threadName);
         t.start ();
      }
   }
}

public class TestThread {

   public static void main(String args[]) {
      PrintDemo PD = new PrintDemo();

      ThreadDemo T1 = new ThreadDemo( "Thread - 1 ", PD );
      ThreadDemo T2 = new ThreadDemo( "Thread - 2 ", PD );

      T1.start();
      T2.start();

      // wait for threads to end
      try {
         T1.join();
         T2.join();
      } catch ( Exception e) {
         System.out.println("Interrupted");
      }
   }
}

每次运行此程序都会产生相同的结果 −

This produces the same result every time you run this program −

Output

Starting Thread - 1
Starting Thread - 2
Counter   ---   5
Counter   ---   4
Counter   ---   3
Counter   ---   2
Counter   ---   1
Thread Thread - 1  exiting.
Counter   ---   5
Counter   ---   4
Counter   ---   3
Counter   ---   2
Counter   ---   1
Thread Thread - 2  exiting.

Java - Interthread Communication

如果您了解进程间通信,那么您将很容易理解线程间通信。当您开发两个或更多线程交换某些信息的应用程序时,线程间通信非常重要。

If you are aware of interprocess communication then it will be easy for you to understand interthread communication. Interthread communication is important when you develop an application where two or more threads exchange some information.

有三个简单的方法和一个使线程通信成为可能的小技巧。所有三个方法如下所列 −

There are three simple methods and a little trick which makes thread communication possible. All the three methods are listed below −

Sr.No.

Method & Description

1

public void wait() Causes the current thread to wait until another thread invokes the notify().

2

public void notify() Wakes up a single thread that is waiting on this object’s monitor.

3

public void notifyAll() Wakes up all the threads that called wait( ) on the same object.

这些方法已作为 final 中的对象方法实现,因此在所有类中均可用。所有三个方法只能在 synchronized 上下文中调用。

These methods have been implemented as final methods in Object, so they are available in all the classes. All three methods can be called only from within a synchronized context.

Example

此示例显示了两个线程如何使用 wait()notify() 方法进行通信。您可以使用相同概念创建复杂系统。

This examples shows how two threads can communicate using wait() and notify() method. You can create a complex system using the same concept.

class Chat {
   boolean flag = false;

   public synchronized void Question(String msg) {
      if (flag) {
         try {
            wait();
         } catch (InterruptedException e) {
            e.printStackTrace();
         }
      }
      System.out.println(msg);
      flag = true;
      notify();
   }

   public synchronized void Answer(String msg) {
      if (!flag) {
         try {
            wait();
         } catch (InterruptedException e) {
            e.printStackTrace();
         }
      }

      System.out.println(msg);
      flag = false;
      notify();
   }
}

class T1 implements Runnable {
   Chat m;
   String[] s1 = { "Hi", "How are you ?", "I am also doing fine!" };

   public T1(Chat m1) {
      this.m = m1;
      new Thread(this, "Question").start();
   }

   public void run() {
      for (int i = 0; i < s1.length; i++) {
         m.Question(s1[i]);
      }
   }
}

class T2 implements Runnable {
   Chat m;
   String[] s2 = { "Hi", "I am good, what about you?", "Great!" };

   public T2(Chat m2) {
      this.m = m2;
      new Thread(this, "Answer").start();
   }

   public void run() {
      for (int i = 0; i < s2.length; i++) {
         m.Answer(s2[i]);
      }
   }
}
public class TestThread {
   public static void main(String[] args) {
      Chat m = new Chat();
      new T1(m);
      new T2(m);
   }
}

Output

Hi
Hi
How are you ?
I am good, what about you?
I am also doing fine!
Great!

Java - Thread Deadlock

死锁描述了两个或多个线程被永久阻塞的情况,等待彼此。当多个线程需要相同锁但按不同顺序获取它们时,会发生死锁。Java 多线程程序可能会受到死锁条件的影响,因为 synchronized 关键字会导致执行线程在等待与指定对象关联的锁或监视器的同时阻塞。这里有一个例子。

Deadlock describes a situation where two or more threads are blocked forever, waiting for each other. Deadlock occurs when multiple threads need the same locks but obtain them in different order. A Java multithreaded program may suffer from the deadlock condition because the synchronized keyword causes the executing thread to block while waiting for the lock, or monitor, associated with the specified object. Here is an example.

Example

public class TestThread {
   public static Object Lock1 = new Object();
   public static Object Lock2 = new Object();

   public static void main(String args[]) {
      ThreadDemo1 T1 = new ThreadDemo1();
      ThreadDemo2 T2 = new ThreadDemo2();
      T1.start();
      T2.start();
   }

   private static class ThreadDemo1 extends Thread {
      public void run() {
         synchronized (Lock1) {
            System.out.println("Thread 1: Holding lock 1...");

            try { Thread.sleep(10); }
            catch (InterruptedException e) {}
            System.out.println("Thread 1: Waiting for lock 2...");

            synchronized (Lock2) {
               System.out.println("Thread 1: Holding lock 1 & 2...");
            }
         }
      }
   }
   private static class ThreadDemo2 extends Thread {
      public void run() {
         synchronized (Lock2) {
            System.out.println("Thread 2: Holding lock 2...");

            try { Thread.sleep(10); }
            catch (InterruptedException e) {}
            System.out.println("Thread 2: Waiting for lock 1...");

            synchronized (Lock1) {
               System.out.println("Thread 2: Holding lock 1 & 2...");
            }
         }
      }
   }
}

当您编译并执行上述程序时,您会发现死锁情况,以下是程序产生的输出 −

When you compile and execute the above program, you find a deadlock situation and following is the output produced by the program −

Output

Thread 1: Holding lock 1...
Thread 2: Holding lock 2...
Thread 1: Waiting for lock 2...
Thread 2: Waiting for lock 1...

上述程序将永久挂起,因为该位置的线程既无法进行,又等待彼此释放锁,所以您可以通过按 CTRL+C 退出程序。

The above program will hang forever because neither of the threads in position to proceed and waiting for each other to release the lock, so you can come out of the program by pressing CTRL+C.

Deadlock Solution Example

让我们更改锁的顺序并运行相同的程序,看看这两个线程是否仍在互相等待 −

Let’s change the order of the lock and run of the same program to see if both the threads still wait for each other −

Example

public class TestThread {
   public static Object Lock1 = new Object();
   public static Object Lock2 = new Object();

   public static void main(String args[]) {
      ThreadDemo1 T1 = new ThreadDemo1();
      ThreadDemo2 T2 = new ThreadDemo2();
      T1.start();
      T2.start();
   }

   private static class ThreadDemo1 extends Thread {
      public void run() {
         synchronized (Lock1) {
            System.out.println("Thread 1: Holding lock 1...");

            try {
               Thread.sleep(10);
            } catch (InterruptedException e) {}
            System.out.println("Thread 1: Waiting for lock 2...");

            synchronized (Lock2) {
               System.out.println("Thread 1: Holding lock 1 & 2...");
            }
         }
      }
   }
   private static class ThreadDemo2 extends Thread {
      public void run() {
         synchronized (Lock1) {
            System.out.println("Thread 2: Holding lock 1...");

            try {
               Thread.sleep(10);
            } catch (InterruptedException e) {}
            System.out.println("Thread 2: Waiting for lock 2...");

            synchronized (Lock2) {
               System.out.println("Thread 2: Holding lock 1 & 2...");
            }
         }
      }
   }
}

因此,仅仅更改锁的顺序就可以防止程序进入死锁情况,并完成以下结果 −

So just changing the order of the locks prevent the program in going into a deadlock situation and completes with the following result −

Output

Thread 1: Holding lock 1...
Thread 1: Waiting for lock 2...
Thread 1: Holding lock 1 & 2...
Thread 2: Holding lock 1...
Thread 2: Waiting for lock 2...
Thread 2: Holding lock 1 & 2...

上述示例只是为了说明这个概念,然而,这是一个复杂的概念,在您开发应用程序以处理死锁情况之前,您应该深入了解它。

The above example is to just make the concept clear, however, it is a complex concept and you should deep dive into it before you develop your applications to deal with deadlock situations.

Java - Thread Control

核心 Java 对多线程程序提供了完全控制。您可以开发多线程程序,根据您的要求完全暂停、恢复或停止。有各种静态方法,您可以在线程对象上使用它们来控制它们的 behavior。下表列出了这些方法 −

Core Java provides complete control over multithreaded program. You can develop a multithreaded program which can be suspended, resumed, or stopped completely based on your requirements. There are various static methods which you can use on thread objects to control their behavior. Following table lists down those methods −

Sr.No.

Method & Description

1

public void suspend() This method puts a thread in the suspended state and can be resumed using resume() method.

2

public void stop() This method stops a thread completely.

3

public void resume() This method resumes a thread, which was suspended using suspend() method.

4

public void wait() Causes the current thread to wait until another thread invokes the notify().

5

public void notify() Wakes up a single thread that is waiting on this object’s monitor.

注意,Java 的最新版本已声明 suspend( )、resume( ) 和 stop( ) 方法已弃用,因此你需要使用可用的替代方法。

Be aware that the latest versions of Java has deprecated the usage of suspend( ), resume( ), and stop( ) methods and so you need to use available alternatives.

Example

class RunnableDemo implements Runnable {
   public Thread t;
   private String threadName;
   boolean suspended = false;

   RunnableDemo( String name) {
      threadName = name;
      System.out.println("Creating " +  threadName );
   }

   public void run() {
      System.out.println("Running " +  threadName );
      try {
         for(int i = 10; i > 0; i--) {
            System.out.println("Thread: " + threadName + ", " + i);
            // Let the thread sleep for a while.
            Thread.sleep(300);
            synchronized(this) {
               while(suspended) {
                  wait();
               }
            }
         }
      } catch (InterruptedException e) {
         System.out.println("Thread " +  threadName + " interrupted.");
      }
      System.out.println("Thread " +  threadName + " exiting.");
   }

   public void start () {
      System.out.println("Starting " +  threadName );
      if (t == null) {
         t = new Thread (this, threadName);
         t.start ();
      }
   }

   void suspend() {
      suspended = true;
   }

   synchronized void resume() {
      suspended = false;
      notify();
   }
}

public class TestThread {

   public static void main(String args[]) {

      RunnableDemo R1 = new RunnableDemo( "Thread-1");
      R1.start();

      RunnableDemo R2 = new RunnableDemo( "Thread-2");
      R2.start();

      try {
         Thread.sleep(1000);
         R1.suspend();
         System.out.println("Suspending First Thread");
         Thread.sleep(1000);
         R1.resume();
         System.out.println("Resuming First Thread");

         R2.suspend();
         System.out.println("Suspending thread Two");
         Thread.sleep(1000);
         R2.resume();
         System.out.println("Resuming thread Two");
      } catch (InterruptedException e) {
         System.out.println("Main thread Interrupted");
      }try {
         System.out.println("Waiting for threads to finish.");
         R1.t.join();
         R2.t.join();
      } catch (InterruptedException e) {
         System.out.println("Main thread Interrupted");
      }
      System.out.println("Main thread exiting.");
   }
}

以上程序产生以下输出 −

The above program produces the following output −

Output

Creating Thread-1
Starting Thread-1
Creating Thread-2
Starting Thread-2
Running Thread-1
Thread: Thread-1, 10
Running Thread-2
Thread: Thread-2, 10
Thread: Thread-1, 9
Thread: Thread-2, 9
Thread: Thread-1, 8
Thread: Thread-2, 8
Thread: Thread-1, 7
Thread: Thread-2, 7
Suspending First Thread
Thread: Thread-2, 6
Thread: Thread-2, 5
Thread: Thread-2, 4
Resuming First Thread
Suspending thread Two
Thread: Thread-1, 6
Thread: Thread-1, 5
Thread: Thread-1, 4
Thread: Thread-1, 3
Resuming thread Two
Thread: Thread-2, 3
Waiting for threads to finish.
Thread: Thread-1, 2
Thread: Thread-2, 2
Thread: Thread-1, 1
Thread: Thread-2, 1
Thread Thread-1 exiting.
Thread Thread-2 exiting.
Main thread exiting.

Java - Networking

网络编程一词是指编写跨多台设备(计算机)执行的程序,其中这些设备都是通过网络彼此连接的。

The term network programming refers to writing programs that execute across multiple devices (computers), in which the devices are all connected to each other using a network.

J2SE API 的 java.net 包含一组类和接口,用于提供低级通信细节,让您可以编写专注于解决当前问题的程序。

The java.net package of the J2SE APIs contains a collection of classes and interfaces that provide the low-level communication details, allowing you to write programs that focus on solving the problem at hand.

java.net 包提供对两种常见网络协议的支持 −

The java.net package provides support for the two common network protocols −

  1. TCP − TCP stands for Transmission Control Protocol, which allows for reliable communication between two applications. TCP is typically used over the Internet Protocol, which is referred to as TCP/IP.

  2. UDP − UDP stands for User Datagram Protocol, a connection-less protocol that allows for packets of data to be transmitted between applications.

本章对以下两个主题进行了很好的阐述 −

This chapter gives a good understanding on the following two subjects −

  1. Socket Programming − This is the most widely used concept in Networking and it has been explained in very detail.

  2. URL Processing − This would be covered separately. Click here to learn about URL Processing in Java language.

Socket Programming

套接字使用 TCP 在两台计算机之间提供通信机制。客户端程序在其通信端创建套接字,并尝试将该套接字连接到服务器。

Sockets provide the communication mechanism between two computers using TCP. A client program creates a socket on its end of the communication and attempts to connect that socket to a server.

建立连接时,服务器在其通信端创建一个套接字对象。现在,客户端和服务器可以通过向套接字写入和从套接字读取来进行通信。

When the connection is made, the server creates a socket object on its end of the communication. The client and the server can now communicate by writing to and reading from the socket.

java.net.Socket 类表示一个套接字,而 java.net.ServerSocket 类为服务器程序提供了一种机制,用于侦听客户端并与它们建立连接。

The java.net.Socket class represents a socket, and the java.net.ServerSocket class provides a mechanism for the server program to listen for clients and establish connections with them.

使用套接字在两台计算机之间建立 TCP 连接时,会发生以下步骤 −

The following steps occur when establishing a TCP connection between two computers using sockets −

  1. The server instantiates a ServerSocket object, denoting which port number communication is to occur on.

  2. The server invokes the accept() method of the ServerSocket class. This method waits until a client connects to the server on the given port.

  3. After the server is waiting, a client instantiates a Socket object, specifying the server name and the port number to connect to.

  4. The constructor of the Socket class attempts to connect the client to the specified server and the port number. If communication is established, the client now has a Socket object capable of communicating with the server.

  5. On the server side, the accept() method returns a reference to a new socket on the server that is connected to the client’s socket.

建立连接后,可以使用 I/O 流进行通信。每个套接字都有一个 OutputStream 和一个 InputStream。客户端的 OutputStream 连接到服务器的 InputStream,客户端的 InputStream 连接到服务器的 OutputStream。

After the connections are established, communication can occur using I/O streams. Each socket has both an OutputStream and an InputStream. The client’s OutputStream is connected to the server’s InputStream, and the client’s InputStream is connected to the server’s OutputStream.

TCP 是一个双向通信协议,因此可以同时通过两个流发送数据。以下是提供实现套接字的完整方法集的有用类。

TCP is a two-way communication protocol, hence data can be sent across both streams at the same time. Following are the useful classes providing complete set of methods to implement sockets.

ServerSocket Class Methods

服务器应用程序使用 java.net.ServerSocket 类获取端口并侦听客户端请求。

The java.net.ServerSocket class is used by server applications to obtain a port and listen for client requests.

ServerSocket 类有四个构造函数 −

The ServerSocket class has four constructors −

Sr.No.

Method & Description

1

public ServerSocket(int port) throws IOException Attempts to create a server socket bound to the specified port. An exception occurs if the port is already bound by another application.

2

public ServerSocket(int port, int backlog) throws IOException Similar to the previous constructor, the backlog parameter specifies how many incoming clients to store in a wait queue.

3

public ServerSocket(int port, int backlog, InetAddress address) throws IOException Similar to the previous constructor, the InetAddress parameter specifies the local IP address to bind to. The InetAddress is used for servers that may have multiple IP addresses, allowing the server to specify which of its IP addresses to accept client requests on.

4

public ServerSocket() throws IOException Creates an unbound server socket. When using this constructor, use the bind() method when you are ready to bind the server socket.

如果 ServerSocket 构造函数未引发异常,则表示应用程序已成功绑定到指定端口并已准备好接受客户端请求。

If the ServerSocket constructor does not throw an exception, it means that your application has successfully bound to the specified port and is ready for client requests.

以下是 ServerSocket 类的部分常用方法:

Following are some of the common methods of the ServerSocket class −

Sr.No.

Method & Description

1

public int getLocalPort() Returns the port that the server socket is listening on. This method is useful if you passed in 0 as the port number in a constructor and let the server find a port for you.

2

public Socket accept() throws IOException Waits for an incoming client. This method blocks until either a client connects to the server on the specified port or the socket times out, assuming that the time-out value has been set using the setSoTimeout() method. Otherwise, this method blocks indefinitely.

3

public void setSoTimeout(int timeout) Sets the time-out value for how long the server socket waits for a client during the accept().

4

public void bind(SocketAddress host, int backlog) Binds the socket to the specified server and port in the SocketAddress object. Use this method if you have instantiated the ServerSocket using the no-argument constructor.

当 ServerSocket 调用 accept() 时,该方法在客户端连接之前不会返回。在客户端连接后,ServerSocket会在未指定端口上创建新的 Socket,并返回对该新 Socket 的引用。在客户端和服务器间建立 TCP 连接后,便可开始通信。

When the ServerSocket invokes accept(), the method does not return until a client connects. After a client does connect, the ServerSocket creates a new Socket on an unspecified port and returns a reference to this new Socket. A TCP connection now exists between the client and the server, and communication can begin.

Socket Class Methods

java.net.Socket 类表示客户端和服务器用于彼此通信的套接字。客户端通过实例化来获取 Socket 对象,而服务器则通过 accept() 方法的返回值来获取 Socket 对象。

The java.net.Socket class represents the socket that both the client and the server use to communicate with each other. The client obtains a Socket object by instantiating one, whereas the server obtains a Socket object from the return value of the accept() method.

Socket 类有五个构造函数供客户端用于连接到服务器 -

The Socket class has five constructors that a client uses to connect to a server −

Sr.No.

Method & Description

1

public Socket(String host, int port) throws UnknownHostException, IOException. This method attempts to connect to the specified server at the specified port. If this constructor does not throw an exception, the connection is successful and the client is connected to the server.

2

public Socket(InetAddress host, int port) throws IOException This method is identical to the previous constructor, except that the host is denoted by an InetAddress object.

3

public Socket(String host, int port, InetAddress localAddress, int localPort) throws IOException. Connects to the specified host and port, creating a socket on the local host at the specified address and port.

4

public Socket(InetAddress host, int port, InetAddress localAddress, int localPort) throws IOException. This method is identical to the previous constructor, except that the host is denoted by an InetAddress object instead of a String.

5

public Socket() Creates an unconnected socket. Use the connect() method to connect this socket to a server.

当 Socket 构造器返回时,它不仅仅实例化一个 Socket 对象,而且实际上尝试连接到指定的服务器和端口。

When the Socket constructor returns, it does not simply instantiate a Socket object but it actually attempts to connect to the specified server and port.

此处列出 Socket 类中的一些感兴趣的方法。请注意,客户端和服务器都有一个 Socket 对象,因此客户端和服务器都可以调用这些方法。

Some methods of interest in the Socket class are listed here. Notice that both the client and the server have a Socket object, so these methods can be invoked by both the client and the server.

Sr.No.

Method & Description

1

public void connect(SocketAddress host, int timeout) throws IOException This method connects the socket to the specified host. This method is needed only when you instantiate the Socket using the no-argument constructor.

2

public InetAddress getInetAddress() This method returns the address of the other computer that this socket is connected to.

3

public int getPort() Returns the port the socket is bound to on the remote machine.

4

public int getLocalPort() Returns the port the socket is bound to on the local machine.

5

public SocketAddress getRemoteSocketAddress() Returns the address of the remote socket.

6

public InputStream getInputStream() throws IOException Returns the input stream of the socket. The input stream is connected to the output stream of the remote socket.

7

public OutputStream getOutputStream() throws IOException Returns the output stream of the socket. The output stream is connected to the input stream of the remote socket.

8

public void close() throws IOException Closes the socket, which makes this Socket object no longer capable of connecting again to any server.

InetAddress Class Methods

此类表示互联网协议 (IP) 地址。在进行套接字编程时,您可能需要使用以下有用方法:

This class represents an Internet Protocol (IP) address. Here are following usefull methods which you would need while doing socket programming −

Sr.No.

Method & Description

1

static InetAddress getByAddress(byte[] addr) Returns an InetAddress object given the raw IP address.

2

static InetAddress getByAddress(String host, byte[] addr) Creates an InetAddress based on the provided host name and IP address.

3

static InetAddress getByName(String host) Determines the IP address of a host, given the host’s name.

4

String getHostAddress() Returns the IP address string in textual presentation.

5

String getHostName() Gets the host name for this IP address.

6

static InetAddress InetAddress getLocalHost() Returns the local host.

7

String toString() Converts this IP address to a String.

Socket Client Example

以下 GreetingClient 是一个客户端程序,它使用套接字连接到服务器并发送问候语,然后等待响应。

The following GreetingClient is a client program that connects to a server by using a socket and sends a greeting, and then waits for a response.

Example

// File Name GreetingClient.java
import java.net.*;
import java.io.*;

public class GreetingClient {

   public static void main(String [] args) {
      String serverName = args[0];
      int port = Integer.parseInt(args[1]);
      try {
         System.out.println("Connecting to " + serverName + " on port " + port);
         Socket client = new Socket(serverName, port);

         System.out.println("Just connected to " + client.getRemoteSocketAddress());
         OutputStream outToServer = client.getOutputStream();
         DataOutputStream out = new DataOutputStream(outToServer);

         out.writeUTF("Hello from " + client.getLocalSocketAddress());
         InputStream inFromServer = client.getInputStream();
         DataInputStream in = new DataInputStream(inFromServer);

         System.out.println("Server says " + in.readUTF());
         client.close();
      } catch (IOException e) {
         e.printStackTrace();
      }
   }
}

Socket Server Example

以下 GreetingServer 程序是一个服务器应用程序示例,它使用 Socket 类监听命令行参数指定的端口号上的客户端—

The following GreetingServer program is an example of a server application that uses the Socket class to listen for clients on a port number specified by a command-line argument −

Example

// File Name GreetingServer.java
import java.net.*;
import java.io.*;

public class GreetingServer extends Thread {
   private ServerSocket serverSocket;

   public GreetingServer(int port) throws IOException {
      serverSocket = new ServerSocket(port);
      serverSocket.setSoTimeout(10000);
   }

   public void run() {
      while(true) {
         try {
            System.out.println("Waiting for client on port " +
               serverSocket.getLocalPort() + "...");
            Socket server = serverSocket.accept();

            System.out.println("Just connected to " + server.getRemoteSocketAddress());
            DataInputStream in = new DataInputStream(server.getInputStream());

            System.out.println(in.readUTF());
            DataOutputStream out = new DataOutputStream(server.getOutputStream());
            out.writeUTF("Thank you for connecting to " + server.getLocalSocketAddress()
               + "\nGoodbye!");
            server.close();

         } catch (SocketTimeoutException s) {
            System.out.println("Socket timed out!");
            break;
         } catch (IOException e) {
            e.printStackTrace();
            break;
         }
      }
   }

   public static void main(String [] args) {
      int port = Integer.parseInt(args[0]);
      try {
         Thread t = new GreetingServer(port);
         t.start();
      } catch (IOException e) {
         e.printStackTrace();
      }
   }
}

编译客户端和服务器,然后按以下方式启动服务器—

Compile the client and the server and then start the server as follows −

$ java GreetingServer 6066
Waiting for client on port 6066...

按照以下步骤检查客户端程序 −

Check the client program as follows −

Output

$ java GreetingClient localhost 6066
Connecting to localhost on port 6066
Just connected to localhost/127.0.0.1:6066
Server says Thank you for connecting to /127.0.0.1:6066
Goodbye!

Java - URL Processing

URL 代表统一资源定位符,表示万维网上的资源,例如网页或 FTP 目录。

URL stands for Uniform Resource Locator and represents a resource on the World Wide Web, such as a Web page or FTP directory.

此部分向您展示如何编写与 URL 通信的 Java 程序。URL 可以分解为以下部分:

This section shows you how to write Java programs that communicate with a URL. A URL can be broken down into parts, as follows −

protocol://host:port/path?query#ref

协议的示例包括 HTTP、HTTPS、FTP 和文件。此路径也称为文件名,而主机也称为授权。

Examples of protocols include HTTP, HTTPS, FTP, and File. The path is also referred to as the filename, and the host is also called the authority.

以下是一个协议为 HTTP 的网页的 URL:

The following is a URL to a web page whose protocol is HTTP −

https://www.amrood.com/index.htm?language=en#j2se

请注意此 URL 未指定端口,在这种情况下将使用该协议的默认端口。对于 HTTP,默认端口为 80。

Notice that this URL does not specify a port, in which case the default port for the protocol is used. With HTTP, the default port is 80.

Constructors

java.net.URL 类表示一个 URL,并具有用于在 Java 中处理 URL 的一组完整方法。

The java.net.URL class represents a URL and has a complete set of methods to manipulate URL in Java.

URL 类具有多个构造方法,用于创建 URL,包括以下方法:

The URL class has several constructors for creating URLs, including the following −

Sr.No.

Constructors & Description

1

public URL(String protocol, String host, int port, String file) throws MalformedURLException Creates a URL by putting together the given parts.

2

public URL(String protocol, String host, String file) throws MalformedURLException Identical to the previous constructor, except that the default port for the given protocol is used.

3

public URL(String url) throws MalformedURLException Creates a URL from the given String.

4

public URL(URL context, String url) throws MalformedURLException Creates a URL by parsing together the URL and String arguments.

URL 类包含许多用于访问所表示 URL 的各个部分的方法。URL 类中的一些方法包括以下方法:

The URL class contains many methods for accessing the various parts of the URL being represented. Some of the methods in the URL class include the following −

Sr.No.

Method & Description

1

public String getPath() Returns the path of the URL.

2

public String getQuery() Returns the query part of the URL.

3

public String getAuthority() Returns the authority of the URL.

4

public int getPort() Returns the port of the URL.

5

public int getDefaultPort() Returns the default port for the protocol of the URL.

6

public String getProtocol() Returns the protocol of the URL.

7

public String getHost() Returns the host of the URL.

8

public String getHost() Returns the host of the URL.

9

public String getFile() Returns the filename of the URL.

10

public String getRef() Returns the reference part of the URL.

11

public URLConnection openConnection() throws IOException Opens a connection to the URL, allowing a client to communicate with the resource.

Example

以下 URLDemo 程序演示了 URL 的各个部分。URL 输入在命令行上,URLDemo 程序输出给定 URL 的每个部分。

The following URLDemo program demonstrates the various parts of a URL. A URL is entered on the command line, and the URLDemo program outputs each part of the given URL.

// File Name : URLDemo.java
import java.io.IOException;
import java.net.URL;

public class URLDemo {

   public static void main(String [] args) {
      try {
         URL url = new URL("https://www.tutorialspoint.com/index.htm?language=en#j2se");

         System.out.println("URL is " + url.toString());
         System.out.println("protocol is " + url.getProtocol());
         System.out.println("authority is " + url.getAuthority());
         System.out.println("file name is " + url.getFile());
         System.out.println("host is " + url.getHost());
         System.out.println("path is " + url.getPath());
         System.out.println("port is " + url.getPort());
         System.out.println("default port is " + url.getDefaultPort());
         System.out.println("query is " + url.getQuery());
         System.out.println("ref is " + url.getRef());
      } catch (IOException e) {
         e.printStackTrace();
      }
   }
}

此程序的示例运行将生成以下结果 −

A sample run of the this program will produce the following result −

Output

URL is https://www.tutorialspoint.com/index.htm?language=en#j2se
protocol is https
authority is www.tutorialspoint.com
file name is /index.htm?language=en
host is www.tutorialspoint.com
path is /index.htm
port is -1
default port is 443
query is language=en
ref is j2se

URLConnections Class Methods

openConnection() 方法返回 java.net.URLConnection,其子类代表各种类型的 URL 连接的抽象类。

The openConnection() method returns a java.net.URLConnection, an abstract class whose subclasses represent the various types of URL connections.

例如 -

For example −

  1. If you connect to a URL whose protocol is HTTP, the openConnection() method returns an HttpURLConnection object.

  2. If you connect to a URL that represents a JAR file, the openConnection() method returns a JarURLConnection object, etc.

URLConnection 类具有用于设置或确定有关连接信息的许多方法,包括以下方法 −

The URLConnection class has many methods for setting or determining information about the connection, including the following −

Sr.No.

Method & Description

1

Object getContent() Retrieves the contents of this URL connection.

2

Object getContent(Class[] classes) Retrieves the contents of this URL connection.

3

String getContentEncoding() Returns the value of the content-encoding header field.

4

int getContentLength() Returns the value of the content-length header field.

5

String getContentType() Returns the value of the content-type header field.

6

int getLastModified() Returns the value of the last-modified header field.

7

long getExpiration() Returns the value of the expired header field.

8

long getIfModifiedSince() Returns the value of this object’s ifModifiedSince field.

9

public void setDoInput(boolean input) Passes in true to denote that the connection will be used for input. The default value is true because clients typically read from a URLConnection.

10

public void setDoOutput(boolean output) Passes in true to denote that the connection will be used for output. The default value is false because many types of URLs do not support being written to.

11

public InputStream getInputStream() throws IOException Returns the input stream of the URL connection for reading from the resource.

12

public OutputStream getOutputStream() throws IOException Returns the output stream of the URL connection for writing to the resource.

13

public URL getURL() Returns the URL that this URLConnection object is connected to.

Example

以下 URLConnectionDemo 程序连接到从命令行输入的 URL。

The following URLConnectionDemo program connects to a URL entered from the command line.

如果 URL 表示 HTTP 资源,则连接会被强制转换为 HttpURLConnection,并且资源中的数据会被逐行读取。

If the URL represents an HTTP resource, the connection is cast to HttpURLConnection, and the data in the resource is read one line at a time.

// File Name : URLConnDemo.java
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;

   public static void main(String [] args) {
      try {
         URL url = new URL("https://www.tutorialspoint.com");
         URLConnection urlConnection = url.openConnection();
         HttpURLConnection connection = null;
         if(urlConnection instanceof HttpURLConnection) {
            connection = (HttpURLConnection) urlConnection;
         }else {
            System.out.println("Please enter an HTTP URL.");
            return;
         }

         BufferedReader in = new BufferedReader(
            new InputStreamReader(connection.getInputStream()));
         String urlString = "";
         String current;

         while((current = in.readLine()) != null) {
            urlString += current;
         }
         System.out.println(urlString);
      } catch (IOException e) {
         e.printStackTrace();
      }
   }
}

此程序的示例运行将产生以下结果:

A sample run of this program will produce the following result −

Output

$ java URLConnDemo

.....a complete HTML content of home page of tutorialspoint.com.....

Java - Generics

如果能够编写一个单一的 sort 方法对 Integer 数组、String 数组或支持排序的任何类型的数组中的元素进行排序,那就太好了。

It would be nice if we could write a single sort method that could sort the elements in an Integer array, a String array, or an array of any type that supports ordering.

Java Generic 方法和泛型类使程序员能够通过单个方法声明指定一组相关方法,或通过单个类声明指定一组相关类型。

Java Generic methods and generic classes enable programmers to specify, with a single method declaration, a set of related methods, or with a single class declaration, a set of related types, respectively.

泛型还提供编译时类型安全性,使程序员能够在编译时捕捉无效的类型。

Generics also provide compile-time type safety that allows programmers to catch invalid types at compile time.

使用 Java 泛型概念,我们可以为对象数组编写一个泛型方法,然后使用 Integer 数组、Double 数组、String 数组等调用泛型方法,对数组元素进行排序。

Using Java Generic concept, we might write a generic method for sorting an array of objects, then invoke the generic method with Integer arrays, Double arrays, String arrays and so on, to sort the array elements.

Generic Methods

你可以编写一个可以针对不同类型参数调用的单个泛型方法声明。根据传递给泛型方法的参数类型,编译器会分别处理每个方法调用。以下是定义泛型方法的规则:

You can write a single generic method declaration that can be called with arguments of different types. Based on the types of the arguments passed to the generic method, the compiler handles each method call appropriately. Following are the rules to define Generic Methods −

  1. All generic method declarations have a type parameter section delimited by angle brackets (< and >) that precedes the method’s return type ( < E > in the next example).

  2. Each type parameter section contains one or more type parameters separated by commas. A type parameter, also known as a type variable, is an identifier that specifies a generic type name.

  3. The type parameters can be used to declare the return type and act as placeholders for the types of the arguments passed to the generic method, which are known as actual type arguments.

  4. A generic method’s body is declared like that of any other method. Note that type parameters can represent only reference types, not primitive types (like int, double and char).

Example

以下示例说明了如何使用单个泛型方法打印不同类型的数组 -

Following example illustrates how we can print an array of different type using a single Generic method −

public class GenericMethodTest {
   // generic method printArray
   public static < E > void printArray( E[] inputArray ) {
      // Display array elements
      for(E element : inputArray) {
         System.out.printf("%s ", element);
      }
      System.out.println();
   }

   public static void main(String args[]) {
      // Create arrays of Integer, Double and Character
      Integer[] intArray = { 1, 2, 3, 4, 5 };
      Double[] doubleArray = { 1.1, 2.2, 3.3, 4.4 };
      Character[] charArray = { 'H', 'E', 'L', 'L', 'O' };

      System.out.println("Array integerArray contains:");
      printArray(intArray);   // pass an Integer array

      System.out.println("\nArray doubleArray contains:");
      printArray(doubleArray);   // pass a Double array

      System.out.println("\nArray characterArray contains:");
      printArray(charArray);   // pass a Character array
   }
}

Output

Array integerArray contains:
1 2 3 4 5

Array doubleArray contains:
1.1 2.2 3.3 4.4

Array characterArray contains:
H E L L O

Bounded Type Parameters

有时您可能希望限制允许传递给类型参数的类型种类。例如,对数字进行操作的方法可能只希望接受 Number 或其子类的实例。这就是有界类型参数的作用。

There may be times when you’ll want to restrict the kinds of types that are allowed to be passed to a type parameter. For example, a method that operates on numbers might only want to accept instances of Number or its subclasses. This is what bounded type parameters are for.

要声明有界类型参数,请列出类型参数的名称,后跟 extends 关键字,后跟其上限。

To declare a bounded type parameter, list the type parameter’s name, followed by the extends keyword, followed by its upper bound.

Example

以下示例说明了如何以常规意义使用 extends 表示“extends”(如在类中)或“implements”(如在接口中)。此示例是用于返回三个 Comparable 对象中最大的对象的泛型方法 -

Following example illustrates how extends is used in a general sense to mean either "extends" (as in classes) or "implements" (as in interfaces). This example is Generic method to return the largest of three Comparable objects −

public class MaximumTest {
   // determines the largest of three Comparable objects

   public static <T extends Comparable<T>> T maximum(T x, T y, T z) {
      T max = x;   // assume x is initially the largest

      if(y.compareTo(max) > 0) {
         max = y;   // y is the largest so far
      }

      if(z.compareTo(max) > 0) {
         max = z;   // z is the largest now
      }
      return max;   // returns the largest object
   }

   public static void main(String args[]) {
      System.out.printf("Max of %d, %d and %d is %d\n\n",
         3, 4, 5, maximum( 3, 4, 5 ));

      System.out.printf("Max of %.1f,%.1f and %.1f is %.1f\n\n",
         6.6, 8.8, 7.7, maximum( 6.6, 8.8, 7.7 ));

      System.out.printf("Max of %s, %s and %s is %s\n","pear",
         "apple", "orange", maximum("pear", "apple", "orange"));
   }
}

Output

Max of 3, 4 and 5 is 5

Max of 6.6,8.8 and 7.7 is 8.8

Max of pear, apple and orange is pear

Generic Classes

泛型类声明看起来像非泛型类声明,除了类名后跟类型参数部分。

A generic class declaration looks like a non-generic class declaration, except that the class name is followed by a type parameter section.

与泛型方法一样,泛型类的类型参数部分可以有多个类型参数,用逗号分隔。这些类被称为参数化类或参数化类型,因为它们接受一个或多个参数。

As with generic methods, the type parameter section of a generic class can have one or more type parameters separated by commas. These classes are known as parameterized classes or parameterized types because they accept one or more parameters.

Example

以下示例说明了如何定义泛型类 -

Following example illustrates how we can define a generic class −

public class Box<T> {
   private T t;

   public void add(T t) {
      this.t = t;
   }

   public T get() {
      return t;
   }

   public static void main(String[] args) {
      Box<Integer> integerBox = new Box<Integer>();
      Box<String> stringBox = new Box<String>();

      integerBox.add(new Integer(10));
      stringBox.add(new String("Hello World"));

      System.out.printf("Integer Value :%d\n\n", integerBox.get());
      System.out.printf("String Value :%s\n", stringBox.get());
   }
}

Output

Integer Value :10
String Value :Hello World

Java - Collections Framework

在 Java 2 之前,Java 提供了诸如 Dictionary, Vector, Stack,Properties 等特殊类来存储和操作对象组。尽管这些类非常有用,但它们缺少一个中心统一的主题。因此,您使用 Vector 的方式与您使用 Properties 的方式不同。

Prior to Java 2, Java provided ad hoc classes such as Dictionary, Vector, Stack, and Properties to store and manipulate groups of objects. Although these classes were quite useful, they lacked a central, unifying theme. Thus, the way that you used Vector was different from the way that you used Properties.

集合框架旨在满足若干目标,例如-

The collections framework was designed to meet several goals, such as −

  1. The framework had to be high-performance. The implementations for the fundamental collections (dynamic arrays, linked lists, trees, and hashtables) were to be highly efficient.

  2. The framework had to allow different types of collections to work in a similar manner and with a high degree of interoperability.

  3. The framework had to extend and/or adapt a collection easily.

为此目的,整个 collections 框架围绕一组标准接口进行设计。提供 LinkedList, HashSet,TreeSet 等这些接口的几个标准实现,您可以按原样使用它们,也可以根据需要实现自己的集合。

Towards this end, the entire collections framework is designed around a set of standard interfaces. Several standard implementations such as LinkedList, HashSet, and TreeSet, of these interfaces are provided that you may use as-is and you may also implement your own collection, if you choose.

集合框架是一个用于表示和操作集合的统一体系结构。所有集合框架包含下列内容:

A collections framework is a unified architecture for representing and manipulating collections. All collections frameworks contain the following −

  1. Interfaces − These are abstract data types that represent collections. Interfaces allow collections to be manipulated independently of the details of their representation. In object-oriented languages, interfaces generally form a hierarchy.

  2. Implementations, i.e., Classes − These are the concrete implementations of the collection interfaces. In essence, they are reusable data structures.

  3. Algorithms − These are the methods that perform useful computations, such as searching and sorting, on objects that implement collection interfaces. The algorithms are said to be polymorphic: that is, the same method can be used on many different implementations of the appropriate collection interface.

除了集合之外,该框架还定义了几个映射接口和类。映射存储键值对。虽然在该术语的正确使用中,映射不是集合,但它们与集合完全集成。

In addition to collections, the framework defines several map interfaces and classes. Maps store key/value pairs. Although maps are not collections in the proper use of the term, but they are fully integrated with collections.

The Collection Interfaces

集合框架定义了几个接口。本节概述了每个接口:

The collections framework defines several interfaces. This section provides an overview of each interface −

Sr.No.

Interface & Description

1

*The Collection Interface*This enables you to work with groups of objects; it is at the top of the collections hierarchy.

2

The List InterfaceThis extends Collection and an instance of List stores an ordered collection of elements.

3

The SetThis extends Collection to handle sets, which must contain unique elements.

4

The SortedSetThis extends Set to handle sorted sets.

5

The MapThis maps unique keys to values.

6

The Map.EntryThis describes an element (a key/value pair) in a map. This is an inner class of Map.

7

The SortedMapThis extends Map so that the keys are maintained in an ascending order.

8

The EnumerationThis is legacy interface defines the methods by which you can enumerate (obtain one at a time) the elements in a collection of objects. This legacy interface has been superceded by Iterator.

The Collection Classes

Java 提供了一组实现 Collection 接口的标准集合类。有些类提供了可按原样使用的完整实现,而另一些类是抽象类,提供用作创建具体集合的起点的骨架实现。

Java provides a set of standard collection classes that implement Collection interfaces. Some of the classes provide full implementations that can be used as-is and others are abstract class, providing skeletal implementations that are used as starting points for creating concrete collections.

标准集合类总结在以下表中 −

The standard collection classes are summarized in the following table −

Sr.No.

Class & Description

1

AbstractCollection Implements most of the Collection interface.

2

AbstractList Extends AbstractCollection and implements most of the List interface.

3

AbstractSequentialList Extends AbstractList for use by a collection that uses sequential rather than random access of its elements.

4

AbstractSet Extends AbstractCollection and implements most of the Set interface.

5

AbstractMap Implements most of the Map interface.

AbstractCollection、AbstractSet、AbstractList、AbstractSequentialList 和 AbstractMap 类提供了核心集合接口的基本实现,以最大程度减少实现这些接口所需的工作量。

The AbstractCollection, AbstractSet, AbstractList, AbstractSequentialList and AbstractMap classes provide skeletal implementations of the core collection interfaces, to minimize the effort required to implement them.

java.util 定义的以下旧类已在上一章中讨论过−

The following legacy classes defined by java.util have been discussed in the previous chapter −

Sr.No.

Class & Description

1

QueueThe queue interface is provided in java.util package and it implements the Collection interface. The queue implements FIFO i.e. First In First Out. This means that the elements entered first are the ones that are deleted first.

The Collection Algorithms

集合框架定义了可以应用于集合和映射的几种算法。这些算法在 Collections 类中被定义为静态方法。

The collections framework defines several algorithms that can be applied to collections and maps. These algorithms are defined as static methods within the Collections class.

其中有些方法会抛出 ClassCastException,当尝试比较不兼容的类型时会发生 ClassCastException 错误,当尝试修改不可修改集合时会发生 UnsupportedOperationException 错误。

Several of the methods can throw a ClassCastException, which occurs when an attempt is made to compare incompatible types, or an UnsupportedOperationException, which occurs when an attempt is made to modify an unmodifiable collection.

集合定义了三个静态变量:EMPTY_SET、EMPTY_LIST 和 EMPTY_MAP。所有都是不可变的。

Collections define three static variables: EMPTY_SET, EMPTY_LIST, and EMPTY_MAP. All are immutable.

Sr.No.

Algorithm & Description

1

The Collection AlgorithmsHere is a list of all the algorithm implementation.

How to Use an Iterator ?

通常,您会希望在集合中的元素间循环。例如,您可能希望显示每个元素。

Often, you will want to cycle through the elements in a collection. For example, you might want to display each element.

最简单的做法是使用迭代器,它是一个实现了 Iterator 或 ListIterator 接口的对象。

The easiest way to do this is to employ an iterator, which is an object that implements either the Iterator or the ListIterator interface.

迭代器使您能够在集合中循环,获取或删除元素。ListIterator 扩展了 Iterator,以允许双向遍历列表并修改元素。

Iterator enables you to cycle through a collection, obtaining or removing elements. ListIterator extends Iterator to allow bidirectional traversal of a list and the modification of elements.

Sr.No.

Iterator Method & Description

1

Using Java IteratorHere is a list of all the methods with examples provided by Iterator and ListIterator interfaces.

How to Use a Comparator ?

TreeSet 和 TreeMap 都将元素存储在排序顺序中。但是,正是比较器精确地定义了排序顺序的含义。

Both TreeSet and TreeMap store elements in a sorted order. However, it is the comparator that defines precisely what sorted order means.

该接口允许我们对给定集合进行任意次数的不同方式的排序。此接口还可以用于对任何类的任何实例(包括我们无法修改的类)进行排序。

This interface lets us sort a given collection any number of different ways. Also this interface can be used to sort any instances of any class (even classes we cannot modify).

Sr.No.

Iterator Method & Description

1

Using Java ComparatorHere is a list of all the methods with examples provided by Comparator Interface.

How to Use a Comparable ?

TreeSet 和 TreeMap 都按顺序存储元素。我们可以使用 Comparable 接口精确定义排序顺序的意思。

Both TreeSet and TreeMap store elements in a sorted order. We can use Comparable interface that defines precisely what sorted order means.

该接口允许我们对给定集合进行任意次数的不同方式的排序。此接口还可以用于对任何类的任何实例(包括我们无法修改的类)进行排序。

This interface lets us sort a given collection any number of different ways. Also this interface can be used to sort any instances of any class (even classes we cannot modify).

Sr.No.

Iterator Method & Description

1

Using Java ComparableHere is a list of all the methods with examples provided by Comparable Interface.

Summary

Java 集合框架为程序员提供了预先打包的数据结构和用于操作这些数据结构的算法。

The Java collections framework gives the programmer access to prepackaged data structures as well as to algorithms for manipulating them.

集合是可以引用其他对象的类。集合接口声明了可在每种类型的集合上执行的操作。

A collection is an object that can hold references to other objects. The collection interfaces declare the operations that can be performed on each type of collection.

集合框架的类和接口都包含在包 java.util 中。

The classes and interfaces of the collections framework are in package java.util.

Java - The List Interface

List 接口扩展 Collection 并声明存储元素序列的集合的行为。

The List interface extends Collection and declares the behavior of a collection that stores a sequence of elements.

  1. Elements can be inserted or accessed by their position in the list, using a zero-based index.

  2. A list may contain duplicate elements.

  3. In addition to the methods defined by Collection, List defines some of its own, which are summarized in the following table.

  4. Several of the list methods will throw an UnsupportedOperationException if the collection cannot be modified, and a ClassCastException is generated when one object is incompatible with another.

Sr.No.

Method & Description

1

void add(int index, Object obj) Inserts obj into the invoking list at the index passed in the index. Any pre-existing elements at or beyond the point of insertion are shifted up. Thus, no elements are overwritten.

2

boolean addAll(int index, Collection c) Inserts all elements of c into the invoking list at the index passed in the index. Any pre-existing elements at or beyond the point of insertion are shifted up. Thus, no elements are overwritten. Returns true if the invoking list changes and returns false otherwise.

3

Object get(int index) Returns the object stored at the specified index within the invoking collection.

4

int indexOf(Object obj) Returns the index of the first instance of obj in the invoking list. If obj is not an element of the list, .1 is returned.

5

int lastIndexOf(Object obj) Returns the index of the last instance of obj in the invoking list. If obj is not an element of the list, .1 is returned.

6

ListIterator listIterator( ) Returns an iterator to the start of the invoking list.

7

ListIterator listIterator(int index) Returns an iterator to the invoking list that begins at the specified index.

8

Object remove(int index) Removes the element at position index from the invoking list and returns the deleted element. The resulting list is compacted. That is, the indexes of subsequent elements are decremented by one.

9

Object set(int index, Object obj) Assigns obj to the location specified by index within the invoking list.

10

List subList(int start, int end) Returns a list that includes elements from start to end.1 in the invoking list. Elements in the returned list are also referenced by the invoking object.

Example 1

上述接口已使用 ArrayList 实现。以下是使用上述集合方法中各个类实现的一示例,用于解释一些方法:

The above interface has been implemented using ArrayList. Following is the example to explain few methods from various class implementation of the above collection methods −

import java.util.ArrayList;
import java.util.List;
public class CollectionsDemo {

   public static void main(String[] args) {
      List<String> a1 = new ArrayList<>();
      a1.add("Zara");
      a1.add("Mahnaz");
      a1.add("Ayan");
      System.out.println(" ArrayList Elements");
      System.out.print("\t" + a1);
   }
}

Output

 ArrayList Elements
   [Zara, Mahnaz, Ayan]

Example 2

上述接口已使用 LinkedList 实现。以下是使用上述集合方法中各个类实现的一示例,用于解释一些方法:

The above interface has been implemented using LinkedList. Following is the example to explain few methods from various class implementation of the above collection methods −

import java.util.LinkedList;
import java.util.List;
public class CollectionsDemo {

   public static void main(String[] args) {
      List<String> a1 = new LinkedList<>();
      a1.add("Zara");
      a1.add("Mahnaz");
      a1.add("Ayan");
      System.out.println(" LinkedList Elements");
      System.out.print("\t" + a1);
   }
}

Output

 LinkedList Elements
   [Zara, Mahnaz, Ayan]

Example 3

上述接口已使用 ArrayList 实现。以下是另一个示例,用于使用上述集合方法中各个类实现的一示例,用于解释一些方法:

The above interface has been implemented using ArrayList. Following is another example to explain few methods from various class implementation of the above collection methods −

import java.util.ArrayList;
import java.util.List;
public class CollectionsDemo {

   public static void main(String[] args) {
      List<String> a1 = new ArrayList<>();
      a1.add("Zara");
      a1.add("Mahnaz");
      a1.add("Ayan");
      System.out.println(" ArrayList Elements");
      System.out.print("\t" + a1);

      // remove second element
      a1.remove(1);

      System.out.println("\n ArrayList Elements");
      System.out.print("\t" + a1);
   }
}

Output

 ArrayList Elements
   [Zara, Mahnaz, Ayan]
 ArrayList Elements
   [Zara, Ayan]

Java - Queue Interface

Queue 接口在 java.util 包中提供,它实现了集合接口。队列实现 FIFO,即先入先出。这意味着首先输入的元素是首先被删除的元素。队列通常用于在处理元素之前保存元素。一旦处理了一个元素,它就会从队列中删除,并且下一个元素将被选中进行处理。

The Queue interface is provided in java.util package and it implements the Collection interface. The queue implements FIFO i.e. First In First Out. This means that the elements entered first are the ones that are deleted first. A queue is generally used to hold elements before processing them. Once an element is processed then it is removed from the queue and next item is picked for processing.

Declaration

public interface Queue<E>
   extends Collection<E>

Queue Methods

以下是队列接口的所有实现类实现的重要队列方法的列表 −

Following is the list of the important queue methods that all the implementation classes of the Queue interface implement −

Sr.No.

Method & Description

1

boolean add(E e)This method inserts the specified element into this queue if it is possible to do so immediately without violating capacity restrictions, returning true upon success and throwing an IllegalStateException if no space is currently available.

2

E element()This method retrieves, but does not remove, the head of this queue.

3

boolean offer(E e)This method inserts the specified element into this queue if it is possible to do so immediately without violating capacity restrictions.

4

E peek()This method retrieves, but does not remove, the head of this queue, or returns null if this queue is empty.

5

E poll()This method retrieves and removes the head of this queue, or returns null if this queue is empty.

6

E remove()This method retrieves and removes the head of this queue.

Methods inherited

此接口继承下列接口中的方法-

This interface inherits methods from the following interfaces −

  1. java.util.Collection

  2. java.lang.Iterable

Example

在此示例中,我们使用 LinkedList 实例来显示队列添加、窥视和大小操作。

In this example, we’re using a LinkedList instance to show queue add, peek and size operations.

package com.tutorialspoint;

import java.util.LinkedList;
import java.util.Queue;

public class QueueDemo {
   public static void main(String[] args) {
      Queue<Integer> q = new LinkedList<>();
      q.add(6);
      q.add(1);
      q.add(8);
      q.add(4);
      q.add(7);
      System.out.println("The queue is: " + q);
      int num1 = q.remove();
      System.out.println("The element deleted from the head is: " + num1);
      System.out.println("The queue after deletion is: " + q);
      int head = q.peek();
      System.out.println("The head of the queue is: " + head);
      int size = q.size();
      System.out.println("The size of the queue is: " + size);
   }
}

Output

The queue is: [6, 1, 8, 4, 7]
The element deleted from the head is: 6
The queue after deletion is: [1, 8, 4, 7]
The head of the queue is: 1
The size of the queue is: 4

Java - The Map Interface

Map 接口将唯一密钥映射到值。密钥是您用来稍后检索值的某个对象。

The Map interface maps unique keys to values. A key is an object that you use to retrieve a value at a later date.

  1. Given a key and a value, you can store the value in a Map object. After the value is stored, you can retrieve it by using its key.

  2. Several methods throw a NoSuchElementException when no items exist in the invoking map.

  3. A ClassCastException is thrown when an object is incompatible with the elements in a map.

  4. A NullPointerException is thrown if an attempt is made to use a null object and null is not allowed in the map.

  5. An UnsupportedOperationException is thrown when an attempt is made to change an unmodifiable map.

Sr.No.

Method & Description

1

void clear( ) Removes all key/value pairs from the invoking map.

2

boolean containsKey(Object k) Returns true if the invoking map contains k as a key. Otherwise, returns false.

3

boolean containsValue(Object v) Returns true if the map contains v as a value. Otherwise, returns false.

4

Set entrySet( ) Returns a Set that contains the entries in the map. The set contains objects of type Map.Entry. This method provides a set-view of the invoking map.

5

boolean equals(Object obj) Returns true if obj is a Map and contains the same entries. Otherwise, returns false.

6

Object get(Object k) Returns the value associated with the key k.

7

int hashCode( ) Returns the hash code for the invoking map.

8

boolean isEmpty( ) Returns true if the invoking map is empty. Otherwise, returns false.

9

Set keySet( ) Returns a Set that contains the keys in the invoking map. This method provides a set-view of the keys in the invoking map.

10

Object put(Object k, Object v) Puts an entry in the invoking map, overwriting any previous value associated with the key. The key and value are k and v, respectively. Returns null if the key did not already exist. Otherwise, the previous value linked to the key is returned.

11

void putAll(Map m) Puts all the entries from m into this map.

12

Object remove(Object k) Removes the entry whose key equals k.

13

int size( ) Returns the number of key/value pairs in the map.

14

Collection values( ) Returns a collection containing the values in the map. This method provides a collection-view of the values in the map.

Example 1

Map 在各种类中都有其实现,如 HashMap。以下是如何解释地图功能的一个示例 −

Map has its implementation in various classes like HashMap. Following is an example to explain map functionality −

import java.util.HashMap;
import java.util.Map;
public class CollectionsDemo {

   public static void main(String[] args) {
      Map<String, String> m1 = new HashMap<>();
      m1.put("Zara", "8");
      m1.put("Mahnaz", "31");
      m1.put("Ayan", "12");
      m1.put("Daisy", "14");

      System.out.println();
      System.out.println(" Map Elements");
      System.out.print("\t" + m1);
   }
}

Output

Map Elements
	{Daisy = 14, Ayan = 12, Zara = 8, Mahnaz = 31}

Example 2

Map 在各种类中都有其实现,如 TreeMap,它基于密钥对条目进行排序。以下是如何使用 TreeMap 解释地图功能的示例 −

Map has its implementation in various classes like TreeMap which sorts the entries based on keys. Following is an example to explain map functionality using TreeMap −

import java.util.Map;
import java.util.TreeMap;

public class CollectionsDemo {

   public static void main(String[] args) {
      Map<String, String> m1 = new TreeMap<>();
      m1.put("Zara", "8");
      m1.put("Mahnaz", "31");
      m1.put("Ayan", "12");
      m1.put("Daisy", "14");

      System.out.println();
      System.out.println(" Map Elements");
      System.out.print("\t" + m1);
   }
}

Output

 Map Elements
	{Ayan=12, Daisy=14, Mahnaz=31, Zara=8}

Example 3

映射在各种类中有着其实现,例如 HashMap。下面举例说明了使用 HashMap 来向映射添加和移除元素的映射功能:

Map has its implementation in various classes like HashMap. Following is an example to explain map functions using HashMap to add and remove elements to the map−

import java.util.HashMap;
import java.util.Map;
public class CollectionsDemo {

   public static void main(String[] args) {
      Map<String, String> m1 = new HashMap<>();
      m1.put("Zara", "8");
      m1.put("Mahnaz", "31");
      m1.put("Ayan", "12");
      m1.put("Daisy", "14");

      System.out.println();
      System.out.println(" Map Elements");
      System.out.print("\t" + m1);

      m1.remove("Daisy");
	  System.out.println(" Map Elements");
      System.out.print("\t" + m1);
   }
}

Output

 Map Elements
	{Daisy=14, Ayan=12, Zara=8, Mahnaz=31} Map Elements
	{Ayan=12, Zara=8, Mahnaz=31}

Java - The SortedMap Interface

SortedMap 接口扩展了 Map。它确保按升序保持条目。

The SortedMap interface extends Map. It ensures that the entries are maintained in an ascending key order.

当调用映射中没有项时,多个方法会抛出一个 NoSuchElementException 异常。当对象与地图中的元素不兼容时,会抛出一个 ClassCastException 异常。如果尝试在不允许地图中的 null 时使用 null 对象,会抛出一个 NullPointerException 异常。

Several methods throw a NoSuchElementException when no items are in the invoking map. A ClassCastException is thrown when an object is incompatible with the elements in a map. A NullPointerException is thrown if an attempt is made to use a null object when null is not allowed in the map.

SortedMap 声明的方法汇总在以下表格中 −

The methods declared by SortedMap are summarized in the following table −

Sr.No.

Method & Description

1

Comparator comparator( ) Returns the invoking sorted map’s comparator. If the natural ordering is used for the invoking map, null is returned.

2

Object firstKey( ) Returns the first key in the invoking map.

3

SortedMap headMap(Object end) Returns a sorted map for those map entries with keys that are less than end.

4

Object lastKey( ) Returns the last key in the invoking map.

5

SortedMap subMap(Object start, Object end) Returns a map containing those entries with keys that are greater than or equal to start and less than end.

6

SortedMap tailMap(Object start) Returns a map containing those entries with keys that are greater than or equal to start.

Example 1

以下是一个显示 TreeMap 如何用于获取 SortedMap 值的示例 -

Following is an example showing how TreeMap can be used to get values of a SortedMap −

import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.SortedMap;
import java.util.TreeMap;

public class MapDemo {

   public static void main(String args[]) {
      // Create a hash map
      SortedMap<String, Double> map = new TreeMap<>();

      // Put elements to the map
      map.put("Zara", Double.valueOf(3434.34));
      map.put("Mahnaz", Double.valueOf(123.22));
      map.put("Ayan", Double.valueOf(1378.00));
      map.put("Daisy", Double.valueOf(99.22));
      map.put("Qadir", Double.valueOf(-19.08));

      // Get a set of the entries
      Set<Map.Entry<String, Double>> set = map.entrySet();

      // Get an iterator
      Iterator<Map.Entry<String, Double>> i = set.iterator();

      // Display elements
      while(i.hasNext()) {
         Map.Entry<String, Double> me = i.next();
         System.out.print(me.getKey() + ": ");
         System.out.println(me.getValue());
      }
   }
}

Output

Daisy: 99.22
Ayan: 1378.0
Zara: 3434.34
Qadir: -19.08
Mahnaz: 123.22

Example 2

以下是一个显示 TreeMap 如何用于设置 SortedMap 值的示例 -

Following is an example showing how TreeMap can be used to set values of a SortedMap −

import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.SortedMap;
import java.util.TreeMap;

public class MapDemo {

   public static void main(String args[]) {
      // Create a hash map
      SortedMap<String, Double> map = new TreeMap<>();

      // Put elements to the map
      map.put("Zara", Double.valueOf(3434.34));
      map.put("Mahnaz", Double.valueOf(123.22));
      map.put("Ayan", Double.valueOf(1378.00));
      map.put("Daisy", Double.valueOf(99.22));
      map.put("Qadir", Double.valueOf(-19.08));

      // Get a set of the entries
      Set<Map.Entry<String, Double>> set = map.entrySet();

      // Get an iterator
      Iterator<Map.Entry<String, Double>> i = set.iterator();

      // Display elements
      while(i.hasNext()) {
         Map.Entry<String, Double> me = i.next();
         me.setValue(me.getValue() * 10);
         System.out.print(me.getKey() + ": ");
         System.out.println(me.getValue());
      }
   }
}

Output

Daisy: 992.2
Ayan: 13780.0
Zara: 34343.4
Qadir: -190.79999999999998
Mahnaz: 1232.2

Example 3

以下是一个显示 TreeMap 如何用于获取分类映射项的键的示例 -

Following is an example showing how a TreeMap can be used to get key of a sortedMap entry −

import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.SortedMap;
import java.util.TreeMap;

public class MapDemo {

   public static void main(String args[]) {
      // Create a hash map
      SortedMap<String, Double> map = new TreeMap<>();

      // Put elements to the map
      map.put("Zara", Double.valueOf(3434.34));
      map.put("Mahnaz", Double.valueOf(123.22));
      map.put("Ayan", Double.valueOf(1378.00));
      map.put("Daisy", Double.valueOf(99.22));
      map.put("Qadir", Double.valueOf(-19.08));

      // Get a set of the entries
      Set<Map.Entry<String, Double>> set = map.entrySet();

      // Get an iterator
      Iterator<Map.Entry<String, Double>> i = set.iterator();

      // Display elements
      while(i.hasNext()) {
         Map.Entry<String, Double> me = i.next();
         System.out.println(me.getKey());
      }
   }
}

Output

Daisy
Ayan
Zara
Qadir
Mahnaz

Java - The Set Interface

集合是指不能包含重复元素的集合。它模拟了数学集合抽象。

A Set is a Collection that cannot contain duplicate elements. It models the mathematical set abstraction.

Set 接口仅包含从集合继承的方法,并增加了不允许重复元素的限制。

The Set interface contains only methods inherited from Collection and adds the restriction that duplicate elements are prohibited.

Set 还对 equals 和 hashCode 操作的行为添加了一个更强的契约,即使 Set 实例的实现类型不同,也能对它们进行有意义的比较。

Set also adds a stronger contract on the behavior of the equals and hashCode operations, allowing Set instances to be compared meaningfully even if their implementation types differ.

Set 声明的方法在以下表中总结 −

The methods declared by Set are summarized in the following table −

Sr.No.

Method & Description

1

add( ) Adds an object to the collection.

2

clear( ) Removes all objects from the collection.

3

contains( ) Returns true if a specified object is an element within the collection.

4

isEmpty( ) Returns true if the collection has no elements.

5

iterator( ) Returns an Iterator object for the collection, which may be used to retrieve an object.

6

remove( ) Removes a specified object from the collection.

7

* size( )* Returns the number of elements in the collection.

Example 1

Set 在各种类中都有其实现,如 HashSet、TreeSet、LinkedHashSet。以下是如何使用 HashSet 解释 Set 功能的示例 −

Set has its implementation in various classes like HashSet, TreeSet, LinkedHashSet. Following is an example to explain Set functionality using HashSet −

import java.util.HashSet;
import java.util.Set;

public class SetDemo {

  public static void main(String args[]) {
      int count[] = {34, 22,10,60,30,22};
      Set<Integer> set = new HashSet<>();
      try {
         for(int i = 0; i < 5; i++) {
            set.add(count[i]);
         }
         System.out.println(set);
      }
      catch(Exception e) {}
   }
}

Output

[34, 22, 10, 60, 30]
The sorted list is:
[10, 22, 30, 34, 60]
The First element of the set is: 10
The last element of the set is: 60

Example 2

Set 在各种类中都有其实现,如 HashSet、TreeSet、LinkedHashSet。以下是如何使用 TreeSet 解释 Set 功能的示例 −

Set has its implementation in various classes like HashSet, TreeSet, LinkedHashSet. Following is an example to explain Set functionality using TreeSet −

import java.util.HashSet;
import java.util.Set;
import java.util.TreeSet;

public class SetDemo {

  public static void main(String args[]) {
      int count[] = {34, 22,10,60,30,22};
      Set<Integer> set = new HashSet<>();
      try {
         for(int i = 0; i < 5; i++) {
            set.add(count[i]);
         }
         System.out.println(set);

         TreeSet<Integer> sortedSet = new TreeSet<>(set);
         System.out.println("The sorted list is:");
         System.out.println(sortedSet);

         System.out.println("The First element of the set is: "+ (Integer)sortedSet.first());
         System.out.println("The last element of the set is: "+ (Integer)sortedSet.last());
      }
      catch(Exception e) {}
   }
}

Output

[34, 22, 10, 60, 30]
The sorted list is:
[10, 22, 30, 34, 60]
The First element of the set is: 10
The last element of the set is: 60

Example 3

Set 在各种类中都有其实现,如 HashSet、TreeSet、LinkedHashSet。以下是如何使用 TreeSet 操作解释 Set 功能的示例 −

Set has its implementation in various classes like HashSet, TreeSet, LinkedHashSet. Following is an example to explain Set functionality using TreeSet opearations −

import java.util.HashSet;
import java.util.Set;
import java.util.TreeSet;

public class SetDemo {

  public static void main(String args[]) {
      int count[] = {34, 22,10,60,30,22};
      Set<Integer> set = new HashSet<>();
      try {
         for(int i = 0; i < 5; i++) {
            set.add(count[i]);
         }
         System.out.println(set);

         TreeSet<Integer> sortedSet = new TreeSet<>(set);
         System.out.println("The sorted list is:");
         System.out.println(sortedSet);

         sortedSet.clear();
         System.out.println("The sorted list is:");
         System.out.println(sortedSet);
      }
      catch(Exception e) {}
   }
}

Output

[34, 22, 10, 60, 30]
The sorted list is:
[10, 22, 30, 34, 60]
The sorted list is:
[]

Java - The SortedSet Interface

SortedSet 接口扩展了 Set,并声明了按升序排序的集合的行为。除了 Set 定义的那些方法外,SortedSet 接口还声明在下表中总结的方法 −

The SortedSet interface extends Set and declares the behavior of a set sorted in an ascending order. In addition to those methods defined by Set, the SortedSet interface declares the methods summarized in the following table −

当调用集中不包含任何项时,若干方法会抛出 NoSuchElementException。当对象与集中元素不兼容时,会抛出 ClassCastException。

Several methods throw a NoSuchElementException when no items are contained in the invoking set. A ClassCastException is thrown when an object is incompatible with the elements in a set.

如果尝试使用 null 对象且集中不允许 null,则会抛出 NullPointerException。

A NullPointerException is thrown if an attempt is made to use a null object and null is not allowed in the set.

Sr.No.

Method & Description

1

Comparator comparator( ) Returns the invoking sorted set’s comparator. If the natural ordering is used for this set, null is returned.

2

Object first( ) Returns the first element in the invoking sorted set.

3

SortedSet headSet(Object end) Returns a SortedSet containing those elements less than end that are contained in the invoking sorted set. Elements in the returned sorted set are also referenced by the invoking sorted set.

4

Object last( ) Returns the last element in the invoking sorted set.

5

SortedSet subSet(Object start, Object end) Returns a SortedSet that includes those elements between start and end.1. Elements in the returned collection are also referenced by the invoking object.

6

SortedSet tailSet(Object start) Returns a SortedSet that contains those elements greater than or equal to start that are contained in the sorted set. Elements in the returned set are also referenced by the invoking object.

Example 1

SortedSet 在 TreeSet 等各种类中实现了其实现。以下是带有 add 操作的 TreeSet 类示例−

SortedSet have its implementation in various classes like TreeSet. Following is an example of a TreeSet class with add operation−

import java.util.Iterator;
import java.util.SortedSet;
import java.util.TreeSet;

public class SortedSetDemo {

   public static void main(String[] args) {
      // Create the sorted set
      SortedSet<String> set = new TreeSet<>();

      // Add elements to the set
      set.add("b");
      set.add("c");
      set.add("a");

      // Iterating over the elements in the set
      Iterator it = set.iterator();

      while (it.hasNext()) {

         // Get element
         Object element = it.next();
         System.out.println(element.toString());
      }
   }
}

Output

a
b
c

Example 2

SortedSet 在 TreeSet 等各种类中实现了其实现。以下是具有 add 和 remove 操作的 TreeSet 类示例 −

SortedSet have its implementation in various classes like TreeSet. Following is an example of a TreeSet class with add and remove operation −

import java.util.Iterator;
import java.util.SortedSet;
import java.util.TreeSet;

public class SortedSetDemo {

   public static void main(String[] args) {
      // Create the sorted set
      SortedSet<String> set = new TreeSet<>();

      // Add elements to the set
      set.add("b");
      set.add("c");
      set.add("a");
      set.add("d");
      set.add("e");
      set.add("f");

      // remove elements
      set.remove("c");
      set.remove("f");

      // Iterating over the elements in the set
      Iterator it = set.iterator();

      while (it.hasNext()) {
         // Get element
         Object element = it.next();
         System.out.println(element.toString());
      }
   }
}

Output

a
b
d
e

Example 3

SortedSet 在 TreeSet 等各种类中实现了其实现。以下是具有 add 和 clear 操作的 TreeSet 类示例 −

SortedSet have its implementation in various classes like TreeSet. Following is an example of a TreeSet class with add and clear operation −

import java.util.Iterator;
import java.util.SortedSet;
import java.util.TreeSet;

public class SortedSetDemo {

   public static void main(String[] args) {
      // Create the sorted set
      SortedSet<String> set = new TreeSet<>();

      // Add elements to the set
      set.add("b");
      set.add("c");
      set.add("a");
      set.add("d");
      set.add("e");
      set.add("f");

      System.out.println(set);

      // remove elements
      set.clear();

      System.out.println(set);
   }
}

Output

[a, b, c, d, e, f]
[]

Java - Data Structures

Java 实用程序包提供的的数据结构非常强大,可以执行广泛的功能。这些数据结构由以下接口和类组成 −

The data structures provided by the Java utility package are very powerful and perform a wide range of functions. These data structures consist of the following interface and classes −

  1. Enumeration

  2. BitSet

  3. Vector

  4. Stack

  5. Dictionary

  6. Hashtable

  7. Properties

现在所有这些类都已成为传统,而 Java-2 引入了一个称为 Collections Framework 的新框架,下一章将对此进行讨论:

All these classes are now legacy and Java-2 has introduced a new framework called Collections Framework, which is discussed in the next chapter −

The Enumeration

枚举接口本身不是一个数据结构,但它在其他数据结构的上下文中非常重要。枚举接口定义了一种从数据结构中检索连续元素的方法。

The Enumeration interface isn’t itself a data structure, but it is very important within the context of other data structures. The Enumeration interface defines a means to retrieve successive elements from a data structure.

例如,Enumeration 定义了一个名为 nextElement 的方法,用于获取包含多个元素的数据结构中的下一个元素。

For example, Enumeration defines a method called nextElement that is used to get the next element in a data structure that contains multiple elements.

Example

以下是显示针对 Vector 使用 Enumeration 的示例。

Following is an example showing usage of Enumeration for a Vector.

import java.util.Vector;
import java.util.Enumeration;

public class EnumerationTester {

   public static void main(String args[]) {
      Enumeration<String> days;
      Vector<String> dayNames = new Vector<>();

      dayNames.add("Sunday");
      dayNames.add("Monday");
      dayNames.add("Tuesday");
      dayNames.add("Wednesday");
      dayNames.add("Thursday");
      dayNames.add("Friday");
      dayNames.add("Saturday");
      days = dayNames.elements();

      while (days.hasMoreElements()) {
         System.out.println(days.nextElement());
      }
   }
}

Output

Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

为了对此接口有更详细的了解,请查看 The Enumeration

To have more detail about this interface, check The Enumeration.

The BitSet

BitSet 类实现了一个可单独设置或清除的位或标志组。

The BitSet class implements a group of bits or flags that can be set and cleared individually.

当需要保留一组布尔值时,这个类非常有用;你只需为每个值分配一个位,并在合适的情况下设置或清除它。

This class is very useful in cases where you need to keep up with a set of Boolean values; you just assign a bit to each value and set or clear it as appropriate.

Example

以下程序说明了此数据结构支持的几种方法 -

The following program illustrates several of the methods supported by this data structure −

import java.util.BitSet;
public class BitSetDemo {

  public static void main(String args[]) {
      BitSet bits1 = new BitSet(16);
      BitSet bits2 = new BitSet(16);

      // set some bits
      for(int i = 0; i < 16; i++) {
         if((i % 2) == 0) bits1.set(i);
         if((i % 5) != 0) bits2.set(i);
      }

      System.out.println("Initial pattern in bits1: ");
      System.out.println(bits1);
      System.out.println("\nInitial pattern in bits2: ");
      System.out.println(bits2);

      // AND bits
      bits2.and(bits1);
      System.out.println("\nbits2 AND bits1: ");
      System.out.println(bits2);

      // OR bits
      bits2.or(bits1);
      System.out.println("\nbits2 OR bits1: ");
      System.out.println(bits2);

      // XOR bits
      bits2.xor(bits1);
      System.out.println("\nbits2 XOR bits1: ");
      System.out.println(bits2);
   }
}

Output

Initial pattern in bits1:
{0, 2, 4, 6, 8, 10, 12, 14}

Initial pattern in bits2:
{1, 2, 3, 4, 6, 7, 8, 9, 11, 12, 13, 14}

bits2 AND bits1:
{2, 4, 6, 8, 12, 14}

bits2 OR bits1:
{0, 2, 4, 6, 8, 10, 12, 14}

bits2 XOR bits1:
{}

The Vector

Vector 类类似于传统的 Java 数组,只不过它可根据需要而增长以容纳新元素。

The Vector class is similar to a traditional Java array, except that it can grow as necessary to accommodate new elements.

和数组一样,可以根据向量中的索引访问向量对象的元素。

Like an array, elements of a Vector object can be accessed via an index into the vector.

使用 Vector 类的优点是,在创建时不必担心将其设置为特定的大小;它会在必要时自动缩小和增长。

The nice thing about using the Vector class is that you don’t have to worry about setting it to a specific size upon creation; it shrinks and grows automatically when necessary.

Example

以下程序说明了此集合支持的几种方法 -

The following program illustrates several of the methods supported by this collection −

import java.util.*;
public class VectorDemo {

   public static void main(String args[]) {
      // initial size is 3, increment is 2
      Vector v = new Vector(3, 2);
      System.out.println("Initial size: " + v.size());
      System.out.println("Initial capacity: " + v.capacity());

      v.addElement(new Integer(1));
      v.addElement(new Integer(2));
      v.addElement(new Integer(3));
      v.addElement(new Integer(4));
      System.out.println("Capacity after four additions: " + v.capacity());

      v.addElement(new Double(5.45));
      System.out.println("Current capacity: " + v.capacity());

      v.addElement(new Double(6.08));
      v.addElement(new Integer(7));
      System.out.println("Current capacity: " + v.capacity());

      v.addElement(new Float(9.4));
      v.addElement(new Integer(10));
      System.out.println("Current capacity: " + v.capacity());

      v.addElement(new Integer(11));
      v.addElement(new Integer(12));
      System.out.println("First element: " + (Integer)v.firstElement());
      System.out.println("Last element: " + (Integer)v.lastElement());

      if(v.contains(new Integer(3)))
         System.out.println("Vector contains 3.");

      // enumerate the elements in the vector.
      Enumeration vEnum = v.elements();
      System.out.println("\nElements in vector:");

      while(vEnum.hasMoreElements())
         System.out.print(vEnum.nextElement() + " ");
      System.out.println();
   }
}

Output

Initial size: 0
Initial capacity: 3
Capacity after four additions: 5
Current capacity: 5
Current capacity: 7
Current capacity: 9
First element: 1
Last element: 12
Vector contains 3.

Elements in vector:
1 2 3 4 5.45 6.08 7 9.4 10 11 12

The Stack

Stack 类实现了元素的后进先出 (LIFO) 栈。

The Stack class implements a last-in-first-out (LIFO) stack of elements.

你可以从字面上将栈看成一个垂直的对象栈;当你添加一个新元素时,它会堆叠在其他元素之上。

You can think of a stack literally as a vertical stack of objects; when you add a new element, it gets stacked on top of the others.

当你从栈中拉出元素时,它是从顶部拉出的。换句话说,你添加到栈中的最后一个元素是返回的第一个元素。

When you pull an element off the stack, it comes off the top. In other words, the last element you added to the stack is the first one to come back off.

Example

以下程序说明了此集合支持的几种方法 -

The following program illustrates several of the methods supported by this collection −

import java.util.*;
public class StackDemo {

   static void showpush(Stack st, int a) {
      st.push(new Integer(a));
      System.out.println("push(" + a + ")");
      System.out.println("stack: " + st);
   }

   static void showpop(Stack st) {
      System.out.print("pop -> ");
      Integer a = (Integer) st.pop();
      System.out.println(a);
      System.out.println("stack: " + st);
   }

   public static void main(String args[]) {
      Stack st = new Stack();
      System.out.println("stack: " + st);
      showpush(st, 42);
      showpush(st, 66);
      showpush(st, 99);
      showpop(st);
      showpop(st);
      showpop(st);
      try {
         showpop(st);
      } catch (EmptyStackException e) {
         System.out.println("empty stack");
      }
   }
}

Output

stack: [ ]
push(42)
stack: [42]
push(66)
stack: [42, 66]
push(99)
stack: [42, 66, 99]
pop -> 99
stack: [42, 66]
pop -> 66
stack: [42]
pop -> 42
stack: [ ]
pop -> empty stack

The Dictionary

Dictionary 类是一个抽象类,它定义了向值映射键的数据结构。

The Dictionary class is an abstract class that defines a data structure for mapping keys to values.

当你想通过特定键而不是整数索引访问数据时,这很有用。

This is useful in cases where you want to be able to access data via a particular key rather than an integer index.

由于 Dictionary 类是抽象的,它只提供键映射的数据结构的框架,而不是特定的实现。

Since the Dictionary class is abstract, it provides only the framework for a key-mapped data structure rather than a specific implementation.

Example

以下示例演示了如何使用 Java Dictionary keys() 方法。我们使用 Integer、Integer 的 Hashtable 对象创建一个字典实例。然后我们向其中添加了一些元素。使用 keys() 方法检索枚举,然后迭代枚举以打印字典的键。

The following example shows the usage of Java Dictionary keys() method. We’re creating a dictionary instance using Hashtable object of Integer, Integer. Then we’ve added few elements to it. An enumeration is retrieved using keys() method and enumeration is then iterated to print the keys of the dictionary.

package com.tutorialspoint;

import java.util.Enumeration;
import java.util.Dictionary;
import java.util.Hashtable;

public class DictionaryDemo {
   public static void main(String[] args) {

      // create a new hashtable
      Dictionary<Integer, Integer> dictionary = new Hashtable<>();

      // add 2 elements
      dictionary.put(1, 1);
      dictionary.put(2, 2);

      Enumeration<Integer> enumeration = dictionary.keys();

      while(enumeration.hasMoreElements()) {
         System.out.println(enumeration.nextElement());
      }
   }
}

Output

2
1

The Hashtable

Hashtable 类提供了一种基于某些用户定义的键结构来组织数据的方法。

The Hashtable class provides a means of organizing data based on some user-defined key structure.

举例来说,在一个地址列表哈希表中,你可以根据 ZIP 编码这样的键存储和对数据进行排序,而不是按一个人的姓名进行排序。

For example, in an address list hash table you could store and sort data based on a key such as ZIP code rather than on a person’s name.

键与哈希表之间的具体含义完全取决于哈希表的用法和它所包含的数据。

The specific meaning of keys with regard to hash tables is totally dependent on the usage of the hash table and the data it contains.

Example

以下示例演示了如何使用 Java Hashtable contains() 方法来检查 Hashtable 中是否存在某个值。我们创建了一个 Integer、Integer 的 Hashtable 对象。然后添加了一些条目,打印出表格,并使用 contains() 检查表格中的两个值。

The following example shows the usage of Java Hashtable contains() method to check if a value is present in a Hashtable or not. We’ve created a Hashtable object of Integer,Integer. Then few entries are added, table is printed and using contains() we’re checking about two values in the table.

package com.tutorialspoint;

import java.util.Hashtable;

public class HashtableDemo {
   public static void main(String args[]) {

      // create hash table
      Hashtable<Integer,Integer> hashtable = new Hashtable<>();

      // populate hash table
      hashtable.put(1, 1);
      hashtable.put(2, 2);
      hashtable.put(3, 3);

      System.out.println("Initial table elements: " + hashtable);
      System.out.println("Hashtable contains 2 as value: " + hashtable.contains(2));
      System.out.println("Hashtable contains 4 as value: " + hashtable.contains(4));
   }
}

Output

Initial table elements: {3=3, 2=2, 1=1}
Hashtable contains 2 as value: true
Hashtable contains 4 as value: false

The Properties

属性是散列表的一个子类。它用于维护值列表,其中键是一个字符串,值也是一个字符串。

Properties is a subclass of Hashtable. It is used to maintain lists of values in which the key is a String and the value is also a String.

许多其他 Java 类都使用 Properties 类。例如,它是 System.getProperties( ) 在获取环境值时返回的对象类型。

The Properties class is used by many other Java classes. For example, it is the type of object returned by System.getProperties( ) when obtaining environmental values.

Example

以下示例演示了如何使用 Java Properties getProperty(String key) 方法根据 Properties 中的键获取值。我们创建了一个 Properties 对象。然后添加了一些条目。使用 getProperty() 方法,检索并打印一个值。

The following example shows the usage of Java Properties getProperty(String key) method to get a value based on a key from a Properties. We’ve created a Properties object. Then few entries are added. Using getProperty() method, a value is retrieved and printed.

package com.tutorialspoint;

import java.util.Properties;

public class PropertiesDemo {
   public static void main(String[] args) {
      Properties properties = new Properties();

      //populate properties object
      properties.put("1", "tutorials");
      properties.put("2", "point");
      properties.put("3", "is best");

      System.out.println("Properties elements: " + properties);
      System.out.println("Value: " + properties.getProperty("1"));
   }
}

Output

Properties elements: {1=tutorials, 2=point, 3=is best}
Value: tutorials

Java - The Enumeration Interface

Enumeration 接口定义了获取的对象集合中元素(一次获取一个)的方法。

The Enumeration interface defines the methods by which you can enumerate (obtain one at a time) the elements in a collection of objects.

此旧版接口已被 Iterator 取代。尽管没有弃用,但 Enumeration 对于新代码来说已过时。然而,它被 Vector 和 Properties 等旧版类定义的几个方法使用,也由其他几个 API 类使用,目前在应用程序代码中广泛使用。

This legacy interface has been superceded by Iterator. Although not deprecated, Enumeration is considered obsolete for new code. However, it is used by several methods defined by the legacy classes such as Vector and Properties, is used by several other API classes, and is currently in widespread use in application code.

Enumeration 声明的方法汇总在以下表格中 −

The methods declared by Enumeration are summarized in the following table −

Sr.No.

Method & Description

1

boolean hasMoreElements( ) When implemented, it must return true while there are still more elements to extract, and false when all the elements have been enumerated.

2

Object nextElement( ) This returns the next object in the enumeration as a generic Object reference.

Example 1

以下是显示针对 Vector 使用 Enumeration 的示例。

Following is an example showing usage of Enumeration for a Vector.

import java.util.Vector;
import java.util.Enumeration;

public class EnumerationTester {

   public static void main(String args[]) {
      Enumeration<String> days;
      Vector<String> dayNames = new Vector<>();

      dayNames.add("Sunday");
      dayNames.add("Monday");
      dayNames.add("Tuesday");
      dayNames.add("Wednesday");
      dayNames.add("Thursday");
      dayNames.add("Friday");
      dayNames.add("Saturday");
      days = dayNames.elements();

      while (days.hasMoreElements()) {
         System.out.println(days.nextElement());
      }
   }
}

Output

Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

Example 2

以下是一个示例,演示了如何使用 Enumeration 来打印 Properties 中的值。

Following is an example showing usage of Enumeration for a Properties to print the values.

import java.util.Vector;
import java.util.Enumeration;
import java.util.Properties;

public class EnumerationTester {

   public static void main(String args[]) {
      Enumeration<Object> days;
      Properties dayNames = new Properties();

      dayNames.put(1, "Sunday");
      dayNames.put(2,"Monday");
      dayNames.put(3,"Tuesday");
      dayNames.put(4,"Wednesday");
      dayNames.put(5,"Thursday");
      dayNames.put(6,"Friday");
      dayNames.put(7,"Saturday");
      days = dayNames.elements();

      while (days.hasMoreElements()) {
         System.out.println(days.nextElement());
      }
   }
}

Output

Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

Java - The Collection Algorithms

集合框架定义了几种可应用于集合和映射的算法。

The collections framework defines several algorithms that can be applied to collections and maps.

这些算法被定义为 Collections 类的静态方法。其中一些方法可能会抛出 ClassCastException,这是在尝试比较不兼容的类型时发生的,或者 UnsupportedOperationException,这是在尝试修改不可修改的集合时发生的。

These algorithms are defined as static methods within the Collections class. Several of the methods can throw a ClassCastException, which occurs when an attempt is made to compare incompatible types, or an UnsupportedOperationException, which occurs when an attempt is made to modify an unmodifiable collection.

集合框架算法中定义的方法总结在以下表格中 -

The methods defined in collection framework’s algorithm are summarized in the following table −

Sr.No.

Method & Description

1

static int binarySearch(List list, Object value, Comparator c) Searches for value in the list ordered according to c. Returns the position of value in list, or -1 if value is not found.

2

static int binarySearch(List list, Object value) Searches for value in the list. The list must be sorted. Returns the position of value in list, or -1 if value is not found.

3

static void copy(List list1, List list2) Copies the elements of list2 to list1.

4

static Enumeration enumeration(Collection c) Returns an enumeration over c.

5

static void fill(List list, Object obj) Assigns obj to each element of the list.

6

static int indexOfSubList(List list, List subList) Searches list for the first occurrence of subList. Returns the index of the first match, or .1 if no match is found.

7

static int lastIndexOfSubList(List list, List subList) Searches list for the last occurrence of subList. Returns the index of the last match, or .1 if no match is found.

8

static ArrayList list(Enumeration enum) Returns an ArrayList that contains the elements of enum.

9

static Object max(Collection c, Comparator comp) Returns the maximum element in c as determined by comp.

10

static Object max(Collection c) Returns the maximum element in c as determined by natural ordering. The collection need not be sorted.

11

static Object min(Collection c, Comparator comp) Returns the minimum element in c as determined by comp. The collection need not be sorted.

12

static Object min(Collection c) Returns the minimum element in c as determined by natural ordering.

13

static List nCopies(int num, Object obj) Returns num copies of obj contained in an immutable list. num must be greater than or equal to zero.

14

static boolean replaceAll(List list, Object old, Object new) Replaces all occurrences of old with new in the list. Returns true if at least one replacement occurred. Returns false, otherwise.

15

static void reverse(List list) Reverses the sequence in list.

16

static Comparator reverseOrder( ) Returns a reverse comparator.

17

static void rotate(List list, int n) Rotates list by n places to the right. To rotate left, use a negative value for n.

18

static void shuffle(List list, Random r) Shuffles (i.e., randomizes) the elements in the list by using r as a source of random numbers.

19

static void shuffle(List list) Shuffles (i.e., randomizes) the elements in list.

20

static Set singleton(Object obj) Returns obj as an immutable set. This is an easy way to convert a single object into a set.

21

static List singletonList(Object obj) Returns obj as an immutable list. This is an easy way to convert a single object into a list.

22

static Map singletonMap(Object k, Object v) Returns the key/value pair k/v as an immutable map. This is an easy way to convert a single key/value pair into a map.

23

static void sort(List list, Comparator comp) Sorts the elements of list as determined by comp.

24

static void sort(List list) Sorts the elements of the list as determined by their natural ordering.

25

static void swap(List list, int idx1, int idx2) Exchanges the elements in the list at the indices specified by idx1 and idx2.

26

static Collection synchronizedCollection(Collection c) Returns a thread-safe collection backed by c.

27

static List synchronizedList(List list) Returns a thread-safe list backed by list.

28

static Map synchronizedMap(Map m) Returns a thread-safe map backed by m.

29

static Set synchronizedSet(Set s) Returns a thread-safe set backed by s.

30

static SortedMap synchronizedSortedMap(SortedMap sm) Returns a thread-safe sorted set backed by sm.

31

static SortedSet synchronizedSortedSet(SortedSet ss) Returns a thread-safe set backed by ss.

32

static Collection unmodifiableCollection(Collection c) Returns an unmodifiable collection backed by c.

33

static List unmodifiableList(List list) Returns an unmodifiable list backed by the list.

34

static Map unmodifiableMap(Map m) Returns an unmodifiable map backed by m.

35

static Set unmodifiableSet(Set s) Returns an unmodifiable set backed by s.

36

static SortedMap unmodifiableSortedMap(SortedMap sm) Returns an unmodifiable sorted map backed by sm.

37

static SortedSet unmodifiableSortedSet(SortedSet ss) Returns an unmodifiable sorted set backed by ss.

Example 1

下面是一个示例,演示使用 LinkedList 添加元素并以相反顺序对其元素进行排序的各种算法。使用迭代器,遍历列表,然后对其进行改组,最后检索并打印最小值和最大值。

Following is an example, which demonstrates various algorithms using LinkedList to add elements and sort its elements in reverse order. Using iterator, list is iterated then shuffled and lastly minimum and maximum values are retrieved and printed.

import java.util.Collections;
import java.util.Comparator;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;
public class AlgorithmsDemo {

   public static void main(String args[]) {

      // Create and initialize linked list
      List<Integer< ll = new LinkedList<<();
      ll.add(Integer.valueOf(-8));
      ll.add(Integer.valueOf(20));
      ll.add(Integer.valueOf(-20));
      ll.add(Integer.valueOf(8));

      // Create a reverse order comparator
      Comparator<Integer< r = Collections.reverseOrder();

      // Sort list by using the comparator
      Collections.sort(ll, r);

      // Get iterator
      Iterator<Integer< li = ll.iterator();
      System.out.print("List sorted in reverse: ");

      while(li.hasNext()) {
         System.out.print(li.next() + " ");
      }
      System.out.println();
   }
}

Output

List sorted in reverse: 20 8 -8 -20

Example 2

下面是一个示例,演示使用 LinkedList 添加元素并以自然顺序对其元素进行排序的各种算法。使用迭代器,遍历列表,然后对其进行改组,最后检索并打印最小值和最大值。

Following is an example, which demonstrates various algorithms using LinkedList to add elements and sort its elements in natural order. Using iterator, list is iterated then shuffled and lastly minimum and maximum values are retrieved and printed.

import java.util.Collections;
import java.util.Comparator;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;
public class AlgorithmsDemo {

   public static void main(String args[]) {

      // Create and initialize linked list
      List<Integer> ll = new LinkedList<>();
      ll.add(Integer.valueOf(-8));
      ll.add(Integer.valueOf(20));
      ll.add(Integer.valueOf(-20));
      ll.add(Integer.valueOf(8));


      // Sort list by using the default comparator
      Collections.sort(ll);

      // Get iterator
      Iterator<Integer> li = ll.iterator();
      System.out.print("List sorted: ");

      while(li.hasNext()) {
         System.out.print(li.next() + " ");
      }
      System.out.println();
      Collections.shuffle(ll);

      // display randomized list
      li = ll.iterator();
      System.out.print("List shuffled: ");

      while(li.hasNext()) {
         System.out.print(li.next() + " ");
      }

      System.out.println();
      System.out.println("Minimum: " + Collections.min(ll));
      System.out.println("Maximum: " + Collections.max(ll));
   }
}

Output

List sorted: -20 -8 8 20
List shuffled: -20 -8 20 8
Minimum: -20
Maximum: 20

Example 3

下面是一个示例,演示使用 LinkedList 添加字符串元素并以自然顺序对其元素进行排序的各种算法。打印列表,然后对其进行改组,最后检索并打印最小值和最大值。

Following is an example, which demonstrates various algorithms using LinkedList to add String elements and sort its elements in natural order. List is printed then shuffled and lastly minimum and maximum values are retrieved and printed.

import java.util.Collections;
import java.util.Comparator;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;

public class AlgorithmsDemo {

   public static void main(String args[]) {

      // Create and initialize linked list
      List<String> list = new LinkedList<>();
      list.add("Ram");
      list.add("Mohan");
      list.add("Julie");
      list.add("Raheem");

      // Sort list by using the default comparator
      Collections.sort(list);

      // print the sorted list
      System.out.println("Sorted List: " + list);

      // shuffle the list
      Collections.shuffle(list);

      // print the shuffled list
      System.out.println("Shuffled List: " + list);

      System.out.println("Minimum: " + Collections.min(list));
      System.out.println("Maximum: " + Collections.max(list));
   }
}

Output

Sorted List: [Julie, Mohan, Raheem, Ram]
Shuffled List: [Mohan, Raheem, Julie, Ram]
Minimum: Julie
Maximum: Ram

Java - How to Use Iterator?

通常情况下,您需要遍历集合中的元素。例如,您可能需要显示每个元素。执行此操作最简单的方法是使用迭代器,该迭代器是一个实现 Iterator 或 ListIterator 接口的对象。

Often, you will want to cycle through the elements in a collection. For example, you might want to display each element. The easiest way to do this is to employ an iterator, which is an object that implements either the Iterator or the ListIterator interface.

Iterator 让您可以循环处理集合,获取或移除元素。ListIterator 扩展 Iterator 以允许双向遍历列表并修改元素。

Iterator enables you to cycle through a collection, obtaining or removing elements. ListIterator extends Iterator to allow bidirectional traversal of a list, and the modification of elements.

在您可以通过迭代器访问集合之前,必须获取一个迭代器。每个集合类都提供了一个 iterator( ) 方法,该方法返回一个迭代器,用于集合的开始。通过使用此迭代器对象,您可以一次访问集合中的每个元素。

Before you can access a collection through an iterator, you must obtain one. Each of the collection classes provides an iterator( ) method that returns an iterator to the start of the collection. By using this iterator object, you can access each element in the collection, one element at a time.

一般来说,要使用迭代器循环处理集合的内容,请执行以下步骤:

In general, to use an iterator to cycle through the contents of a collection, follow these steps −

  1. Obtain an iterator to the start of the collection by calling the collection’s iterator( ) method.

  2. Set up a loop that makes a call to hasNext( ). Have the loop iterate as long as hasNext( ) returns true.

  3. Within the loop, obtain each element by calling next( ).

对于实现 List 的集合,您还可以通过调用 ListIterator 来获取一个迭代器。

For collections that implement List, you can also obtain an iterator by calling ListIterator.

The Methods Declared by Iterator

Sr.No.

Method & Description

1

boolean hasNext( ) Returns true if there are more elements. Otherwise, returns false.

2

Object next( ) Returns the next element. Throws NoSuchElementException if there is not a next element.

3

void remove( ) Removes the current element. Throws IllegalStateException if an attempt is made to call remove( ) that is not preceded by a call to next( ).

The Methods Declared by ListIterator

Sr.No.

Method & Description

1

void add(Object obj) Inserts obj into the list in front of the element that will be returned by the next call to next( ).

2

boolean hasNext( ) Returns true if there is a next element. Otherwise, returns false.

3

boolean hasPrevious( ) Returns true if there is a previous element. Otherwise, returns false.

4

Object next( ) Returns the next element. A NoSuchElementException is thrown if there is not a next element.

5

int nextIndex( ) Returns the index of the next element. If there is not a next element, returns the size of the list.

6

Object previous( ) Returns the previous element. A NoSuchElementException is thrown if there is not a previous element.

7

int previousIndex( ) Returns the index of the previous element. If there is not a previous element, returns -1.

8

void remove( ) Removes the current element from the list. An IllegalStateException is thrown if remove( ) is called before next( ) or previous( ) is invoked.

9

void set(Object obj) Assigns obj to the current element. This is the element last returned by a call to either next( ) or previous( ).

Example 1

以下示例演示了 Iterator 的使用。它使用了一个 ArrayList 对象,但一般原理适用于任何类型的集合。

Here is an example demonstrating Iterator. It uses an ArrayList object, but the general principles apply to any type of collection.

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

public class IteratorDemo {

   public static void main(String args[]) {
      // Create an array list
      List<String> al = new ArrayList<>();

      // add elements to the array list
      al.add("C");
      al.add("A");
      al.add("E");
      al.add("B");
      al.add("D");
      al.add("F");

      // Use iterator to display contents of al
      System.out.print("Original contents of al: ");
      Iterator itr = al.iterator();

      while(itr.hasNext()) {
         Object element = itr.next();
         System.out.print(element + " ");
      }
      System.out.println();
   }
}

Output

Original contents of al: C A E B D F

Example 2

以下示例演示了 ListIterator 的使用。它使用了一个 ArrayList 对象,但一般原理适用于任何类型的集合。

Here is an example demonstrating ListIterator. It uses an ArrayList object, but the general principles apply to any type of collection.

当然,ListIterator 仅适用于那些实现 List 接口的集合。

Of course, ListIterator is available only to those collections that implement the List interface.

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.ListIterator;
public class IteratorDemo {

   public static void main(String args[]) {
      // Create an array list
      List<String> al = new ArrayList<>();

      // add elements to the array list
      al.add("C");
      al.add("A");
      al.add("E");
      al.add("B");
      al.add("D");
      al.add("F");

      // Use iterator to display contents of al
      System.out.print("Original contents of al: ");
      Iterator<String> itr = al.iterator();

      while(itr.hasNext()) {
         Object element = itr.next();
         System.out.print(element + " ");
      }
   }
}

Output

Original contents of al: C A E B D F

Example 3

以下示例演示了 ListIterator 如何在迭代时修改列表。它使用了一个 ArrayList 对象,但一般原理适用于任何类型的集合。

Here is an example demonstrating ListIterator to modify the list while iterating. It uses an ArrayList object, but the general principles apply to any type of collection.

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.ListIterator;
public class IteratorDemo {

   public static void main(String args[]) {
      // Create an array list
      List<String> al = new ArrayList<>();

      // add elements to the array list
      al.add("C");
      al.add("A");
      al.add("E");
      al.add("B");
      al.add("D");
      al.add("F");

      // Use iterator to display contents of al
      System.out.print("Original contents of al: ");
      Iterator<String> itr = al.iterator();

      while(itr.hasNext()) {
         Object element = itr.next();
         System.out.print(element + " ");
      }
      System.out.println();

      // Modify objects being iterated
      ListIterator<String> litr = al.listIterator();

      while(litr.hasNext()) {
         Object element = litr.next();
         litr.set(element + "+");
      }
      System.out.print("Modified contents of al: ");
      itr = al.iterator();

      while(itr.hasNext()) {
         Object element = itr.next();
         System.out.print(element + " ");
      }
      System.out.println();

      // Now, display the list backwards
      System.out.print("Modified list backwards: ");

      while(litr.hasPrevious()) {
         Object element = litr.previous();
         System.out.print(element + " ");
      }
      System.out.println();
   }
}

Output

Original contents of al: C A E B D F
Modified contents of al: C+ A+ E+ B+ D+ F+
Modified list backwards: F+ D+ B+ E+ A+ C+

Java - How to Use Comparator?

TreeSet 和 TreeMap 都按排序顺序存储元素。然而,是比较器严格定义了排序顺序的含义。

Both TreeSet and TreeMap store elements in sorted order. However, it is the comparator that defines precisely what sorted order means.

Comparator 接口定义了两个方法:compareTo() 和 equals()。这里显示的 compareTo() 方法,比较两个元素的顺序 −

The Comparator interface defines two methods: compare( ) and equals( ). The compare( ) method, shown here, compares two elements for order −

The compare Method

int compare(Object obj1, Object obj2)

obj1 和 obj2 是要比较的对象。如果对象相等,此方法返回零。如果 obj1 大于 obj2,则它返回正值。否则,返回负值。

obj1 and obj2 are the objects to be compared. This method returns zero if the objects are equal. It returns a positive value if obj1 is greater than obj2. Otherwise, a negative value is returned.

通过重写 compareTo(),您可以改变对象的排序方式。例如,要按相反顺序进行排序,可以创建一个逆转比较结果的比较器。

By overriding compare( ), you can alter the way that objects are ordered. For example, to sort in a reverse order, you can create a comparator that reverses the outcome of a comparison.

The equals Method

这里显示的 equals() 方法,测试一个对象是否等于调用的比较器 −

The equals( ) method, shown here, tests whether an object equals the invoking comparator −

boolean equals(Object obj)

obj 是要测试是否相等的对象。如果 obj 和调用对象都是 Comparator 对象并且使用相同的排序,则该方法返回 true。否则,它将返回 false。

obj is the object to be tested for equality. The method returns true if obj and the invoking object are both Comparator objects and use the same ordering. Otherwise, it returns false.

重写 equals() 没有必要,大多数简单的比较器不会这样做。

Overriding equals( ) is unnecessary, and most simple comparators will not do so.

Example 1

在这个示例中,我们使用 Comparator 接口来根据比较条件对自定义对象 Dog 进行排序。

In this example, we’re using Comparator interface to sort a custom object Dog based on comparison criterias.

import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.List;

class Dog implements Comparator<Dog>, Comparable<Dog> {
   private String name;
   private int age;
   Dog() {
   }

   Dog(String n, int a) {
      name = n;
      age = a;
   }

   public String getDogName() {
      return name;
   }

   public int getDogAge() {
      return age;
   }

   // Overriding the compareTo method
   public int compareTo(Dog d) {
      return (this.name).compareTo(d.name);
   }

   // Overriding the compare method to sort the age
   public int compare(Dog d, Dog d1) {
      return d.age - d1.age;
   }

   @Override
   public String toString() {
      return this.name + "," + this.age;
   }
}

public class ComparatorDemo {

   public static void main(String args[]) {
      // Takes a list o Dog objects
      List<Dog> list = new ArrayList<>();

      list.add(new Dog("Shaggy", 3));
      list.add(new Dog("Lacy", 2));
      list.add(new Dog("Roger", 10));
      list.add(new Dog("Tommy", 4));
      list.add(new Dog("Tammy", 1));

      Collections.sort(list);   // Sorts the array list
      System.out.println("Sorted by name:");
      // printing the sorted list of names
      System.out.print(list);

      // Sorts the array list using comparator
      Collections.sort(list, new Dog());
      System.out.println(" ");

      System.out.println("Sorted by age:");
      // printing the sorted list of ages
      System.out.print(list);
   }
}

Output

Sorted by name:
[Lacy,2, Roger,10, Shaggy,3, Tammy,1, Tommy,4]
Sorted by age:
[Tammy,1, Lacy,2, Shaggy,3, Tommy,4, Roger,10]

Note − Arrays 类中的排序与 Collections.相同。

Note − Sorting of the Arrays class is as the same as the Collections.

Example 2

在这个示例中,我们使用 Comparator 接口对 Dog 进行反向排序。

In this example, we’re using Comparator interface to reverse sort the Dog objects.

import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.List;

class Dog implements Comparator<Dog>, Comparable<Dog> {
   private String name;
   private int age;
   Dog() {
   }

   Dog(String n, int a) {
      name = n;
      age = a;
   }

   public String getDogName() {
      return name;
   }

   public int getDogAge() {
      return age;
   }

   // Overriding the compareTo method
   public int compareTo(Dog d) {
      return (this.name).compareTo(d.name);
   }

   // Overriding the compare method to sort the age
   public int compare(Dog d, Dog d1) {
      return d.age - d1.age;
   }

   @Override
   public String toString() {
      return this.name + "," + this.age;
   }
}

public class ComparatorDemo {

   public static void main(String args[]) {
      // Takes a list o Dog objects
      List<Dog> list = new ArrayList<>();

      list.add(new Dog("Shaggy", 3));
      list.add(new Dog("Lacy", 2));
      list.add(new Dog("Roger", 10));
      list.add(new Dog("Tommy", 4));
      list.add(new Dog("Tammy", 1));

      Collections.sort(list, Collections.reverseOrder());   // Sorts the array list
      System.out.println("Sorted by name in reverse order:");
      // printing the sorted list of names
      System.out.print(list);
   }
}

Output

Sorted by name in reverse order:
[Tommy,4, Tammy,1, Shaggy,3, Roger,10, Lacy,2]

在这个示例中,我们使用 Comparator 接口对字符串值进行反向排序。

In this example, we’re using Comparator interface to sort String values in reverse order.

Example 3

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class ComparatorDemo {

   public static void main(String args[]) {
      // Takes a list o Dog objects
      List<String> list = new ArrayList<>();

      list.add("Shaggy");
      list.add("Lacy");
      list.add("Roger");
      list.add("Tommy");
      list.add("Tammy");

      Collections.sort(list, Collections.reverseOrder());   // Sorts the array list
      System.out.println("Sorted by name in reverse order:");
      // printing the sorted list of names
      System.out.print(list);
   }
}

Output

Sorted by name in reverse order:
[Tommy, Tammy, Shaggy, Roger, Lacy]

Java - Regular Expressions

Java 提供 java.util.regex 包,用于使用正则表达式进行模式匹配。Java 正则表达式与 Perl 编程语言非常相似,且非常容易学习。

Java provides the java.util.regex package for pattern matching with regular expressions. Java regular expressions are very similar to the Perl programming language and very easy to learn.

正则表达式是由字符组成的特殊序列,它使用模式中包含的专门语法,帮助您匹配或查找其他字符串或字符串集。它们可以用来搜索、编辑或处理文本和数据。

A regular expression is a special sequence of characters that helps you match or find other strings or sets of strings, using a specialized syntax held in a pattern. They can be used to search, edit, or manipulate text and data.

java.util.regex 包主要包含以下三个类 −

The java.util.regex package primarily consists of the following three classes −

  1. Pattern Class − A Pattern object is a compiled representation of a regular expression. The Pattern class provides no public constructors. To create a pattern, you must first invoke one of its public static compile() methods, which will then return a Pattern object. These methods accept a regular expression as the first argument.

  2. Matcher Class − A Matcher object is the engine that interprets the pattern and performs match operations against an input string. Like the Pattern class, Matcher defines no public constructors. You obtain a Matcher object by invoking the matcher() method on a Pattern object.

  3. PatternSyntaxException − A PatternSyntaxException object is an unchecked exception that indicates a syntax error in a regular expression pattern.

Capturing Groups

捕获组是一种将多个字符视为单个单位的方法。它们是通过将待分组的字符置于一组圆括号内创建的。例如,正则表达式 (dog) 创建单个组,其中包含字母“d”、“o”和“g”。

Capturing groups are a way to treat multiple characters as a single unit. They are created by placing the characters to be grouped inside a set of parentheses. For example, the regular expression (dog) creates a single group containing the letters "d", "o", and "g".

捕获组通过从左到右计算其左括号进行编号。例如,在表达式 A)(B© 中,存在四个这样的组 -

Capturing groups are numbered by counting their opening parentheses from the left to the right. In the expression A)(B©, for example, there are four such groups −

  1. A)(B©

  2. (A)

  3. (B©)

  4. ©

若要找出表达式中有多少组,请对匹配器对象调用 groupCount 方法。groupCount 方法返回一个 int,显示匹配器模式中存在的分组数。

To find out how many groups are present in the expression, call the groupCount method on a matcher object. The groupCount method returns an int showing the number of capturing groups present in the matcher’s pattern.

还有一个特殊的组,组 0,它始终代表整个表达式。此组不包括在 groupCount 报告的总数中。

There is also a special group, group 0, which always represents the entire expression. This group is not included in the total reported by groupCount.

Example

以下示例说明如何从给定的字母数字字符串中找到数字字符串 -

Following example illustrates how to find a digit string from the given alphanumeric string −

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class RegexMatches {

   public static void main( String args[] ) {
      // String to be scanned to find the pattern.
      String line = "This order was placed for QT3000! OK?";
      String pattern = "(.*)(\\d+)(.*)";

      // Create a Pattern object
      Pattern r = Pattern.compile(pattern);

      // Now create matcher object.
      Matcher m = r.matcher(line);
      if (m.find( )) {
         System.out.println("Found value: " + m.group(0) );
         System.out.println("Found value: " + m.group(1) );
         System.out.println("Found value: " + m.group(2) );
      }else {
         System.out.println("NO MATCH");
      }
   }
}

Output

Found value: This order was placed for QT3000! OK?
Found value: This order was placed for QT300
Found value: 0

Regular Expression Syntax

以下是列出 Java 中可用的所有正则表达式元字符语法的表格 -

Here is the table listing down all the regular expression metacharacter syntax available in Java −

Subexpression

Matches

^

Matches the beginning of the line.

$

Matches the end of the line.

.

Matches any single character except newline. Using m option allows it to match the newline as well.

[…​]

Matches any single character in brackets.

[^…​]

Matches any single character not in brackets.

\A

Beginning of the entire string.

\z

End of the entire string.

\Z

End of the entire string except allowable final line terminator.

re*

Matches 0 or more occurrences of the preceding expression.

re+

Matches 1 or more of the previous thing.

re?

Matches 0 or 1 occurrence of the preceding expression.

re{ n}

Matches exactly n number of occurrences of the preceding expression.

re{ n,}

Matches n or more occurrences of the preceding expression.

re{ n, m}

Matches at least n and at most m occurrences of the preceding expression.

a

Matches either a or b.

(re)

Groups regular expressions and remembers the matched text.

(?: re)

Groups regular expressions without remembering the matched text.

(?> re)

Matches the independent pattern without backtracking.

\w

Matches the word characters.

\W

Matches the nonword characters.

\s

Matches the whitespace. Equivalent to [\t\n\r\f].

\S

Matches the nonwhitespace.

\d

Matches the digits. Equivalent to [0-9].

\D

Matches the nondigits.

\A

Matches the beginning of the string.

\Z

Matches the end of the string. If a newline exists, it matches just before newline.

\z

Matches the end of the string.

\G

Matches the point where the last match finished.

\n

Back-reference to capture group number "n".

\b

Matches the word boundaries when outside the brackets. Matches the backspace (0x08) when inside the brackets.

\B

Matches the nonword boundaries.

\n, \t, etc.

Matches newlines, carriage returns, tabs, etc.

\Q

Escape (quote) all characters up to \E.

\E

Methods of the Matcher Class

以下是有用的实例方法列表 -

Here is a list of useful instance methods −

Index Methods

索引方法提供有用的索引值,显示在输入字符串中精确匹配的位置 -

Index methods provide useful index values that show precisely where the match was found in the input string −

Sr.No.

Method & Description

1

public int start() Returns the start index of the previous match.

2

public int start(int group) Returns the start index of the subsequence captured by the given group during the previous match operation.

3

public int end() Returns the offset after the last character matched.

4

public int end(int group) Returns the offset after the last character of the subsequence captured by the given group during the previous match operation.

Study Methods

研究方法查看输入字符串,并返回一个布尔值来指示是否找到该模式 -

Study methods review the input string and return a Boolean indicating whether or not the pattern is found −

Sr.No.

Method & Description

1

public boolean lookingAt() Attempts to match the input sequence, starting at the beginning of the region, against the pattern.

2

public boolean find() Attempts to find the next subsequence of the input sequence that matches the pattern.

3

public boolean find(int start) Resets this matcher and then attempts to find the next subsequence of the input sequence that matches the pattern, starting at the specified index.

4

public boolean matches() Attempts to match the entire region against the pattern.

Replacement Methods

替换方法是用于替换输入字符串中的文本的有用方法 −

Replacement methods are useful methods for replacing text in an input string −

Sr.No.

Method & Description

1

public Matcher appendReplacement(StringBuffer sb, String replacement) Implements a non-terminal append-and-replace step.

2

public StringBuffer appendTail(StringBuffer sb) Implements a terminal append-and-replace step.

3

public String replaceAll(String replacement) Replaces every subsequence of the input sequence that matches the pattern with the given replacement string.

4

public String replaceFirst(String replacement) Replaces the first subsequence of the input sequence that matches the pattern with the given replacement string.

5

public static String quoteReplacement(String s) Returns a literal replacement String for the specified String. This method produces a String that will work as a literal replacement s in the appendReplacement method of the Matcher class.

The start and end Methods

以下示例统计了单词“cat”在输入字符串中出现的次数:

Following is the example that counts the number of times the word "cat" appears in the input string −

Example

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class RegexMatches {

   private static final String REGEX = "\\bcat\\b";
   private static final String INPUT = "cat cat cat cattie cat";

   public static void main( String args[] ) {
      Pattern p = Pattern.compile(REGEX);
      Matcher m = p.matcher(INPUT);   // get a matcher object
      int count = 0;

      while(m.find()) {
         count++;
         System.out.println("Match number "+count);
         System.out.println("start(): "+m.start());
         System.out.println("end(): "+m.end());
      }
   }
}

Output

Match number 1
start(): 0
end(): 3
Match number 2
start(): 4
end(): 7
Match number 3
start(): 8
end(): 11
Match number 4
start(): 19
end(): 22

您可以看到,此示例使用了词边界以确保字母“c”、“a”和“t”并非更长单词中的一个子字符串。它还提供了一些有用的信息,说明匹配在输入字符串中的位置。

You can see that this example uses word boundaries to ensure that the letters "c" "a" "t" are not merely a substring in a longer word. It also gives some useful information about where in the input string the match has occurred.

start 方法返回在先前的匹配操作期间给定组捕获的子序列的起始索引,end 返回匹配的最后一个字符的索引加 1。

The start method returns the start index of the subsequence captured by the given group during the previous match operation, and the end returns the index of the last character matched, plus one.

The matches and lookingAt Methods

matches 和 lookingAt 方法均尝试将一个输入序列与模式进行匹配。但区别在于 matches 要求匹配整个输入序列,而 lookingAt 则不要求。

The matches and lookingAt methods both attempt to match an input sequence against a pattern. The difference, however, is that matches requires the entire input sequence to be matched, while lookingAt does not.

两种方法都始终从输入字符串的开头处开始。以下示例说明了该功能:

Both methods always start at the beginning of the input string. Here is the example explaining the functionality −

Example

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class RegexMatches {

   private static final String REGEX = "foo";
   private static final String INPUT = "fooooooooooooooooo";
   private static Pattern pattern;
   private static Matcher matcher;

   public static void main( String args[] ) {
      pattern = Pattern.compile(REGEX);
      matcher = pattern.matcher(INPUT);

      System.out.println("Current REGEX is: "+REGEX);
      System.out.println("Current INPUT is: "+INPUT);

      System.out.println("lookingAt(): "+matcher.lookingAt());
      System.out.println("matches(): "+matcher.matches());
   }
}

Output

Current REGEX is: foo
Current INPUT is: fooooooooooooooooo
lookingAt(): true
matches(): false

The replaceFirst and replaceAll Methods

replaceFirst 和 replaceAll 方法将替换与给定正则表达式匹配的文本。顾名思义,replaceFirst 替换第一个匹配项,而 replaceAll 替换所有匹配项。

The replaceFirst and replaceAll methods replace the text that matches a given regular expression. As their names indicate, replaceFirst replaces the first occurrence, and replaceAll replaces all occurrences.

以下示例说明了该功能:

Here is the example explaining the functionality −

Example

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class RegexMatches {

   private static String REGEX = "dog";
   private static String INPUT = "The dog says meow. " + "All dogs say meow.";
   private static String REPLACE = "cat";

   public static void main(String[] args) {
      Pattern p = Pattern.compile(REGEX);

      // get a matcher object
      Matcher m = p.matcher(INPUT);
      INPUT = m.replaceAll(REPLACE);
      System.out.println(INPUT);
   }
}

Output

The cat says meow. All cats say meow.

The appendReplacement and appendTail Methods

Matcher 类还提供了 appendReplacement 和 appendTail 方法用于文本替换。

The Matcher class also provides appendReplacement and appendTail methods for text replacement.

以下示例说明了该功能:

Here is the example explaining the functionality −

Example

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class RegexMatches {

   private static String REGEX = "a*b";
   private static String INPUT = "aabfooaabfooabfoob";
   private static String REPLACE = "-";
   public static void main(String[] args) {

      Pattern p = Pattern.compile(REGEX);

      // get a matcher object
      Matcher m = p.matcher(INPUT);
      StringBuffer sb = new StringBuffer();
      while(m.find()) {
         m.appendReplacement(sb, REPLACE);
      }
      m.appendTail(sb);
      System.out.println(sb.toString());
   }
}

Output

-foo-foo-foo-

PatternSyntaxException Class Methods

PatternSyntaxException 是一个未经检查的异常,它表示正则表达式模式中的语法错误。PatternSyntaxException 类提供了以下方法来帮助您确定出错的原因:

A PatternSyntaxException is an unchecked exception that indicates a syntax error in a regular expression pattern. The PatternSyntaxException class provides the following methods to help you determine what went wrong −

Sr.No.

Method & Description

1

public String getDescription() Retrieves the description of the error.

2

public int getIndex() Retrieves the error index.

3

public String getPattern() Retrieves the erroneous regular expression pattern.

4

public String getMessage() Returns a multi-line string containing the description of the syntax error and its index, the erroneous regular expression pattern, and a visual indication of the error index within the pattern.

Java - Serialization

Java 提供了一种称为对象序列化的机制,其中对象可以表示为包含对象数据以及有关对象类型和存储在对象中的数据类型的信息的字节序列。

Java provides a mechanism, called object serialization where an object can be represented as a sequence of bytes that includes the object’s data as well as information about the object’s type and the types of data stored in the object.

将序列化对象写到文件后,可以从文件读取它并对其反序列化,即类型信息和表示对象及其数据的字节可用于在内存中重新创建该对象。

After a serialized object has been written into a file, it can be read from the file and deserialized that is, the type information and bytes that represent the object and its data can be used to recreate the object in memory.

最令人印象深刻的是整个过程与 JVM 无关,这意味着可以在一个平台上序列化对象并在完全不同的平台上反序列化。

Most impressive is that the entire process is JVM independent, meaning an object can be serialized on one platform and deserialized on an entirely different platform.

ObjectInputStreamObjectOutputStream 是包含用于序列化和反序列化对象的的高级流。

Classes ObjectInputStream and ObjectOutputStream are high-level streams that contain the methods for serializing and deserializing an object.

ObjectOutputStream 类包含许多用于编写各种数据类型的编写方法,但是有一个方法特别突出 −

The ObjectOutputStream class contains many write methods for writing various data types, but one method in particular stands out −

public final void writeObject(Object x) throws IOException

以上方法对 Object 序列化并将它发送到输出流中。类似地,ObjectInputStream 类包含以下用于反序列化对象的 -

The above method serializes an Object and sends it to the output stream. Similarly, the ObjectInputStream class contains the following method for deserializing an object −

public final Object readObject() throws IOException, ClassNotFoundException

此方法从流中检索下一个 Object 并对其进行反序列化。返回值为 Object,因此你需要将其强制转换为其适当的数据类型。

This method retrieves the next Object out of the stream and deserializes it. The return value is Object, so you will need to cast it to its appropriate data type.

为了演示序列化如何在 Java 中工作,我将使用我们在本书开头讨论过的 Employee 类。假设我们有以下一个实现了 Serializable 接口的 Employee 类:

To demonstrate how serialization works in Java, I am going to use the Employee class that we discussed early on in the book. Suppose that we have the following Employee class, which implements the Serializable interface −

Example

public class Employee implements java.io.Serializable {
   public String name;
   public String address;
   public transient int SSN;
   public int number;

   public void mailCheck() {
      System.out.println("Mailing a check to " + name + " " + address);
   }
}

请注意,若要成功序列化一个类,必须满足两个条件:

Notice that for a class to be serialized successfully, two conditions must be met −

  1. The class must implement the java.io.Serializable interface.

  2. All of the fields in the class must be serializable. If a field is not serializable, it must be marked transient.

如果你好奇一个 Java 标准类是否可序列化,请查看该类的文档。测试很简单:如果该类实现了 java.io.Serializable,那么它是可序列化的;否则,它不可序列化。

If you are curious to know if a Java Standard Class is serializable or not, check the documentation for the class. The test is simple: If the class implements java.io.Serializable, then it is serializable; otherwise, it’s not.

Serializing an Object

ObjectOutputStream 类用于序列化一个对象。以下 SerializeDemo 程序实例化一个 Employee 对象,并将其序列化到一个文件中。

The ObjectOutputStream class is used to serialize an Object. The following SerializeDemo program instantiates an Employee object and serializes it to a file.

当程序执行完毕时,会创建一个名为 employee.ser 的文件。该程序不会生成任何输出,但研究该代码,并尝试确定该程序正在做什么。

When the program is done executing, a file named employee.ser is created. The program does not generate any output, but study the code and try to determine what the program is doing.

Note - 当将一个对象序列化到一个文件中时,Java 中的标准惯例是给该文件一个 .ser 扩展名。

Note − When serializing an object to a file, the standard convention in Java is to give the file a .ser extension.

Example

import java.io.FileOutputStream;
import java.io.IOException;
import java.io.ObjectOutputStream;

public class SerializeDemo {

   public static void main(String [] args) {
      Employee e = new Employee();
      e.name = "Reyan Ali";
      e.address = "Phokka Kuan, Ambehta Peer";
      e.SSN = 11122333;
      e.number = 101;

      try {
         FileOutputStream fileOut = new FileOutputStream("employee.ser");
         ObjectOutputStream out = new ObjectOutputStream(fileOut);
         out.writeObject(e);
         out.close();
         fileOut.close();
         System.out.printf("Serialized data is saved in /tmp/employee.ser");
      } catch (IOException i) {
         i.printStackTrace();
      }
   }
}
class Employee implements java.io.Serializable {
   private static final long serialVersionUID = 1L;
   public String name;
   public String address;
   public transient int SSN;
   public int number;

   public void mailCheck() {
      System.out.println("Mailing a check to " + name + " " + address);
   }
}

Output

Serialized data is saved in employee.ser

Deserializing an Object

以下 DeserializeDemo 程序反序列化在前面程序中创建的 Employee 对象。研究该程序并尝试确定其输出:

The following DeserializeDemo program deserializes the Employee object created in the earlier program. Study the program and try to determine its output −

Example

import java.io.FileInputStream;
import java.io.IOException;
import java.io.ObjectInputStream;

public class DeserializeDemo {

   public static void main(String [] args) {
      Employee e = null;
      try {
         FileInputStream fileIn = new FileInputStream("employee.ser");
         ObjectInputStream in = new ObjectInputStream(fileIn);
         e = (Employee) in.readObject();
         in.close();
         fileIn.close();
      } catch (IOException i) {
         i.printStackTrace();
         return;
      } catch (ClassNotFoundException c) {
         System.out.println("Employee class not found");
         c.printStackTrace();
         return;
      }

      System.out.println("Deserialized Employee...");
      System.out.println("Name: " + e.name);
      System.out.println("Address: " + e.address);
      System.out.println("SSN: " + e.SSN);
      System.out.println("Number: " + e.number);
   }
}
class Employee implements java.io.Serializable {

   private static final long serialVersionUID = 1L;
   public String name;
   public String address;
   public transient int SSN;
   public int number;

   public void mailCheck() {
      System.out.println("Mailing a check to " + name + " " + address);
   }
}

Output

Deserialized Employee...
Name: Reyan Ali
Address:Phokka Kuan, Ambehta Peer
SSN: 0
Number:101

以下是要注意的几个重点:

Here are following important points to be noted −

  1. The try/catch block tries to catch a ClassNotFoundException, which is declared by the readObject() method. For a JVM to be able to deserialize an object, it must be able to find the bytecode for the class. If the JVM can’t find a class during the deserialization of an object, it throws a ClassNotFoundException.

  2. Notice that the return value of readObject() is cast to an Employee reference.

  3. The value of the SSN field was 11122333 when the object was serialized, but because the field is transient, this value was not sent to the output stream. The SSN field of the deserialized Employee object is 0.

Java - Sending Email

使用 Java 应用程序发送电子邮件非常简单,但首先应该在计算机上安装 JavaMail APIJava Activation Framework (JAF)

To send an e-mail using your Java Application is simple enough but to start with you should have JavaMail API and Java Activation Framework (JAF) installed on your machine.

  1. You can download latest version of JavaMail (Version 1.2) from Java’s standard website.

  2. You can download latest version of JAF (Version 1.1.1) from Java’s standard website.

下载并解压缩这些文件,在新建的顶层目录中,你可以找到这两个应用程序的多个 jar 文件。你需要在你的 CLASSPATH 中添加 mail.jaractivation.jar 文件。

Download and unzip these files, in the newly created top level directories you will find a number of jar files for both the applications. You need to add mail.jar and activation.jar files in your CLASSPATH.

Send a Simple E-mail

这里是一个用来从你的机器发送一封简单邮件的示例。假定你的 localhost 已连接至互联网且有能力发送电子邮件。

Here is an example to send a simple e-mail from your machine. It is assumed that your localhost is connected to the Internet and capable enough to send an e-mail.

Example

// File Name SendEmail.java

import java.util.*;
import javax.mail.*;
import javax.mail.internet.*;
import javax.activation.*;

public class SendEmail {

   public static void main(String [] args) {
      // Recipient's email ID needs to be mentioned.
      String to = "abcd@gmail.com";

      // Sender's email ID needs to be mentioned
      String from = "web@gmail.com";

      // Assuming you are sending email from localhost
      String host = "localhost";

      // Get system properties
      Properties properties = System.getProperties();

      // Setup mail server
      properties.setProperty("mail.smtp.host", host);

      // Get the default Session object.
      Session session = Session.getDefaultInstance(properties);

      try {
         // Create a default MimeMessage object.
         MimeMessage message = new MimeMessage(session);

         // Set From: header field of the header.
         message.setFrom(new InternetAddress(from));

         // Set To: header field of the header.
         message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));

         // Set Subject: header field
         message.setSubject("This is the Subject Line!");

         // Now set the actual message
         message.setText("This is actual message");

         // Send message
         Transport.send(message);
         System.out.println("Sent message successfully....");
      } catch (MessagingException mex) {
         mex.printStackTrace();
      }
   }
}

Output

编译并运行此程序来发送一封简单电子邮件 −

Compile and run this program to send a simple e-mail −

$ java SendEmail
Sent message successfully....

如果你想发送电子邮件给多个收件人,那么可以使用以下的方法来指定多个电子邮件 ID −

If you want to send an e-mail to multiple recipients then the following methods would be used to specify multiple e-mail IDs −

void addRecipients(Message.RecipientType type, Address[] addresses)
   throws MessagingException

以下是参数说明 −

Here is the description of the parameters −

  1. type − This would be set to TO, CC or BCC. Here CC represents Carbon Copy and BCC represents Black Carbon Copy. Example: Message.RecipientType.TO

  2. addresses − This is an array of e-mail ID. You would need to use InternetAddress() method while specifying email IDs.

Send an HTML E-mail

这里是一个用来从你的机器发送 HTML 电子邮件的示例。此示例假定你的 localhost 已连接到互联网并且能够发送电子邮件。

Here is an example to send an HTML e-mail from your machine. Here it is assumed that your localhost is connected to the Internet and capable enough to send an e-mail.

这个示例与之前的示例非常相似,不同之处在于,这里我们使用 setContent() 方法来设置内容,其第二个参数是“text/html”,指定该消息中包含 HTML 内容。

This example is very similar to the previous one, except here we are using setContent() method to set content whose second argument is "text/html" to specify that the HTML content is included in the message.

使用这个示例,你可以发送任意长度的 HTML 内容。

Using this example, you can send as big as HTML content you like.

Example

// File Name SendHTMLEmail.java

import java.util.*;
import javax.mail.*;
import javax.mail.internet.*;
import javax.activation.*;

public class SendHTMLEmail {

   public static void main(String [] args) {
      // Recipient's email ID needs to be mentioned.
      String to = "abcd@gmail.com";

      // Sender's email ID needs to be mentioned
      String from = "web@gmail.com";

      // Assuming you are sending email from localhost
      String host = "localhost";

      // Get system properties
      Properties properties = System.getProperties();

      // Setup mail server
      properties.setProperty("mail.smtp.host", host);

      // Get the default Session object.
      Session session = Session.getDefaultInstance(properties);

      try {
         // Create a default MimeMessage object.
         MimeMessage message = new MimeMessage(session);

         // Set From: header field of the header.
         message.setFrom(new InternetAddress(from));

         // Set To: header field of the header.
         message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));

         // Set Subject: header field
         message.setSubject("This is the Subject Line!");

         // Send the actual HTML message, as big as you like
         message.setContent("<h1>This is actual message</h1>", "text/html");

         // Send message
         Transport.send(message);
         System.out.println("Sent message successfully....");
      } catch (MessagingException mex) {
         mex.printStackTrace();
      }
   }
}

编译并运行此程序来发送一封 HTML 电子邮件 −

Compile and run this program to send an HTML e-mail −

Output

$ java SendHTMLEmail
Sent message successfully....

Send Attachment in E-mail

这里是一个用来从你的机器发送带有附件的电子邮件的示例。此示例假定你的 localhost 已连接到互联网且有能力发送电子邮件。

Here is an example to send an e-mail with attachment from your machine. Here it is assumed that your localhost is connected to the internet and capable enough to send an e-mail.

Example

// File Name SendFileEmail.java

import java.util.*;
import javax.mail.*;
import javax.mail.internet.*;
import javax.activation.*;

public class SendFileEmail {

   public static void main(String [] args) {
      // Recipient's email ID needs to be mentioned.
      String to = "abcd@gmail.com";

      // Sender's email ID needs to be mentioned
      String from = "web@gmail.com";

      // Assuming you are sending email from localhost
      String host = "localhost";

      // Get system properties
      Properties properties = System.getProperties();

      // Setup mail server
      properties.setProperty("mail.smtp.host", host);

      // Get the default Session object.
      Session session = Session.getDefaultInstance(properties);

      try {
         // Create a default MimeMessage object.
         MimeMessage message = new MimeMessage(session);

         // Set From: header field of the header.
         message.setFrom(new InternetAddress(from));

         // Set To: header field of the header.
         message.addRecipient(Message.RecipientType.TO,new InternetAddress(to));

         // Set Subject: header field
         message.setSubject("This is the Subject Line!");

         // Create the message part
         BodyPart messageBodyPart = new MimeBodyPart();

         // Fill the message
         messageBodyPart.setText("This is message body");

         // Create a multipar message
         Multipart multipart = new MimeMultipart();

         // Set text message part
         multipart.addBodyPart(messageBodyPart);

         // Part two is attachment
         messageBodyPart = new MimeBodyPart();
         String filename = "file.txt";
         DataSource source = new FileDataSource(filename);
         messageBodyPart.setDataHandler(new DataHandler(source));
         messageBodyPart.setFileName(filename);
         multipart.addBodyPart(messageBodyPart);

         // Send the complete message parts
         message.setContent(multipart );

         // Send message
         Transport.send(message);
         System.out.println("Sent message successfully....");
      } catch (MessagingException mex) {
         mex.printStackTrace();
      }
   }
}

编译并运行此程序来发送一封 HTML 电子邮件 −

Compile and run this program to send an HTML e-mail −

Output

$ java SendFileEmail
Sent message successfully....

User Authentication Part

如果需要为电子邮件服务器提供用户 ID 和密码用于认证目的,那么你可以按以下方式设置这些属性 −

If it is required to provide user ID and Password to the e-mail server for authentication purpose, then you can set these properties as follows −

props.setProperty("mail.user", "myuser");
props.setProperty("mail.password", "mypwd");

发送电子邮件的其余机制保持如上文所述。

Rest of the e-mail sending mechanism would remain as explained above.

Java - Applet Basics

一个 applet 是一个在 Web 浏览器中运行的 Java 程序。小应用程序可以是一个功能齐全的 Java 应用程序,因为它可以使用整个 Java API。

An applet is a Java program that runs in a Web browser. An applet can be a fully functional Java application because it has the entire Java API at its disposal.

小应用程序与独立 Java 应用程序之间有一些重要的区别,包括以下区别 −

There are some important differences between an applet and a standalone Java application, including the following −

  1. An applet is a Java class that extends the java.applet.Applet class.

  2. A main() method is not invoked on an applet, and an applet class will not define main().

  3. Applets are designed to be embedded within an HTML page.

  4. When a user views an HTML page that contains an applet, the code for the applet is downloaded to the user’s machine.

  5. A JVM is required to view an applet. The JVM can be either a plug-in of the Web browser or a separate runtime environment.

  6. The JVM on the user’s machine creates an instance of the applet class and invokes various methods during the applet’s lifetime.

  7. Applets have strict security rules that are enforced by the Web browser. The security of an applet is often referred to as sandbox security, comparing the applet to a child playing in a sandbox with various rules that must be followed.

  8. Other classes that the applet needs can be downloaded in a single Java Archive (JAR) file.

Life Cycle of an Applet

Applet 类中的四种方法为你提供了构建任何重要小程序的基础架构 −

Four methods in the Applet class gives you the framework on which you build any serious applet −

  1. init − This method is intended for whatever initialization is needed for your applet. It is called after the param tags inside the applet tag have been processed.

  2. start − This method is automatically called after the browser calls the init method. It is also called whenever the user returns to the page containing the applet after having gone off to other pages.

  3. stop − This method is automatically called when the user moves off the page on which the applet sits. It can, therefore, be called repeatedly in the same applet.

  4. destroy − This method is only called when the browser shuts down normally. Because applets are meant to live on an HTML page, you should not normally leave resources behind after a user leaves the page that contains the applet.

  5. paint − Invoked immediately after the start() method, and also any time the applet needs to repaint itself in the browser. The paint() method is actually inherited from the java.awt.

A "Hello, World" Applet

这是一个名为 HelloWorldApplet.java 的简单小程序 −

Following is a simple applet named HelloWorldApplet.java −

import java.applet.*;
import java.awt.*;

public class HelloWorldApplet extends Applet {
   public void paint (Graphics g) {
      g.drawString ("Hello World", 25, 50);
   }
}

这些导入语句将类引入到小程序类的范围内 −

These import statements bring the classes into the scope of our applet class −

  1. java.applet.Applet

  2. java.awt.Graphics

如果没有那些导入语句,Java 编译器将无法识别 applet 类引用的类 Applet 和 Graphics。

Without those import statements, the Java compiler would not recognize the classes Applet and Graphics, which the applet class refers to.

The Applet Class

每个小程序都是 java.applet.Applet 类的扩展。基本 Applet 类提供了派生小程序类可以调用的方法,以从浏览器环境获取信息和服务。

Every applet is an extension of the java.applet.Applet class. The base Applet class provides methods that a derived Applet class may call to obtain information and services from the browser context.

其中包括执行以下操作的方法 −

These include methods that do the following −

  1. Get applet parameters

  2. Get the network location of the HTML file that contains the applet

  3. Get the network location of the applet class directory

  4. Print a status message in the browser

  5. Fetch an image

  6. Fetch an audio clip

  7. Play an audio clip

  8. Resize the applet

此外,Applet 类还提供了一个接口,供查看器或浏览器获取有关小程序的信息并控制小程序的执行。查看器可以 −

Additionally, the Applet class provides an interface by which the viewer or browser obtains information about the applet and controls the applet’s execution. The viewer may −

  1. Request information about the author, version, and copyright of the applet

  2. Request a description of the parameters the applet recognizes

  3. Initialize the applet

  4. Destroy the applet

  5. Start the applet’s execution

  6. Stop the applet’s execution

Applet 类为每种方法提供默认实现。可以根据需要覆盖这些实现。

The Applet class provides default implementations of each of these methods. Those implementations may be overridden as necessary.

“Hello, World”小程序在当前状态下是完整的。唯一被覆盖的方法是 paint 方法。

The "Hello, World" applet is complete as it stands. The only method overridden is the paint method.

Invoking an Applet

可以通过将指令嵌入 HTML 文件并在小程序查看器或支持 Java 的浏览器中查看该文件来调用小程序。

An applet may be invoked by embedding directives in an HTML file and viewing the file through an applet viewer or Java-enabled browser.

<applet> 标签是将 applet 嵌入到 HTML 文件中的基础。以下是调用“Hello, World”applet 的示例 −

The <applet> tag is the basis for embedding an applet in an HTML file. Following is an example that invokes the "Hello, World" applet −

<html>
   <title>The Hello, World Applet</title>
   <hr>
   <applet code = "HelloWorldApplet.class" width = "320" height = "120">
      If your browser was Java-enabled, a "Hello, World"
      message would appear here.
   </applet>
   <hr>
</html>

Note −你可以参阅 HTML Applet Tag 以详细了解如何从 HTML 中调用小应用程序。

Note − You can refer to HTML Applet Tag to understand more about calling applet from HTML.

<applet> 标签的 code 属性是必需的。它指定要运行的 Applet 类。还要求宽度和高度来指定小程序运行的面板的初始大小。小程序指令必须使用 </applet> 标签关闭。

The code attribute of the <applet> tag is required. It specifies the Applet class to run. Width and height are also required to specify the initial size of the panel in which an applet runs. The applet directive must be closed with an </applet> tag.

如果小程序带有参数,可以通过在 <applet> 和 </applet> 之间添加 <param> 标签来传递参数值。该浏览器将忽略 applet 标签之间的文本和其他标签。

If an applet takes parameters, values may be passed for the parameters by adding <param> tags between <applet> and </applet>. The browser ignores text and other tags between the applet tags.

不支持 Java 的浏览器不会处理 <applet> 和 </applet>。因此,标签之间的任何内容都与该小程序无关,并且在不支持 Java 的浏览器中是可见的。

Non-Java-enabled browsers do not process <applet> and </applet>. Therefore, anything that appears between the tags, not related to the applet, is visible in non-Java-enabled browsers.

该查看器或浏览器在文档位置查找已编译的 Java 代码。若要另行指定,请使用 <applet> 标签的 codebase 属性,如以下代码所示:

The viewer or browser looks for the compiled Java code at the location of the document. To specify otherwise, use the codebase attribute of the <applet> tag as shown −

<applet codebase = "https://amrood.com/applets" code = "HelloWorldApplet.class"
   width = "320" height = "120">

如果小程序位于其他包中,而且不是默认包,则必须使用句点 (.) 来分隔包/类组件,并通过 code 属性来指定包含的包。例如:

If an applet resides in a package other than the default, the holding package must be specified in the code attribute using the period character (.) to separate package/class components. For example −

<applet  = "mypackage.subpackage.TestApplet.class"
   width = "320" height = "120">

Getting Applet Parameters

以下示例演示如何让小程序响应文档中指定的设置参数。该小程序显示黑白相间的棋盘格图案。

The following example demonstrates how to make an applet respond to setup parameters specified in the document. This applet displays a checkerboard pattern of black and a second color.

可以在文档中将第二种颜色和每个正方形的大小指定为小程序的参数。

The second color and the size of each square may be specified as parameters to the applet within the document.

CheckerApplet 在 init() 方法中获取其参数。它还可以在 paint() 方法中获取其参数。但是,在 applet 开始时获取值并保存设置(而不是每次刷新时),是方便且有效的。

CheckerApplet gets its parameters in the init() method. It may also get its parameters in the paint() method. However, getting the values and saving the settings once at the start of the applet, instead of at every refresh, is convenient and efficient.

小程序查看器或浏览器调用它运行的每个小程序的 init() 方法。该查看器在加载小程序后立即调用 init() 一次。(Applet.init() 被实现为不做任何事情。)为了插入定制初始化代码,请覆盖默认实现。

The applet viewer or browser calls the init() method of each applet it runs. The viewer calls init() once, immediately after loading the applet. (Applet.init() is implemented to do nothing.) Override the default implementation to insert custom initialization code.

Applet.getParameter() 方法获取给定参数名称的参数(参数值始终为字符串)。如果该值为数字或其他非字符数据,则必须对字符串进行解析。

The Applet.getParameter() method fetches a parameter given the parameter’s name (the value of a parameter is always a string). If the value is numeric or other non-character data, the string must be parsed.

以下是 CheckerApplet.java 的结构:

The following is a skeleton of CheckerApplet.java −

import java.applet.*;
import java.awt.*;

public class CheckerApplet extends Applet {
   int squareSize = 50;   // initialized to default size
   public void init() {}
   private void parseSquareSize (String param) {}
   private Color parseColor (String param) {}
   public void paint (Graphics g) {}
}

以下是 CheckerApplet 的 init() 和私有 parseSquareSize() 方法:

Here are CheckerApplet’s init() and private parseSquareSize() methods −

public void init () {
   String squareSizeParam = getParameter ("squareSize");
   parseSquareSize (squareSizeParam);

   String colorParam = getParameter ("color");
   Color fg = parseColor (colorParam);

   setBackground (Color.black);
   setForeground (fg);
}

private void parseSquareSize (String param) {
   if (param == null) return;
   try {
      squareSize = Integer.parseInt (param);
   } catch (Exception e) {
      // Let default value remain
   }
}

该小程序调用 parseSquareSize() 来解析 squareSize 参数。parseSquareSize() 调用库方法 Integer.parseInt(),它解析字符串并返回一个整数。每当其参数无效时,Integer.parseInt() 都会引发异常。

The applet calls parseSquareSize() to parse the squareSize parameter. parseSquareSize() calls the library method Integer.parseInt(), which parses a string and returns an integer. Integer.parseInt() throws an exception whenever its argument is invalid.

因此,parseSquareSize() 捕获异常,而不是让小程序由于错误输入而失败。

Therefore, parseSquareSize() catches exceptions, rather than allowing the applet to fail on bad input.

该小程序调用 parseColor() 将 color 参数解析为 Color 值。parseColor() 执行一系列字符串比较,以将参数值与预定义颜色的名称匹配。您需要实现这些方法才能使此小程序工作。

The applet calls parseColor() to parse the color parameter into a Color value. parseColor() does a series of string comparisons to match the parameter value to the name of a predefined color. You need to implement these methods to make this applet work.

Specifying Applet Parameters

以下是其中嵌入 CheckerApplet 的 HTML 文件的示例。该 HTML 文件通过 <param> 标签指定小程序的两个参数。

The following is an example of an HTML file with a CheckerApplet embedded in it. The HTML file specifies both parameters to the applet by means of the <param> tag.

Example

<html>
   <title>Checkerboard Applet</title>
   <hr>
   <applet code = "CheckerApplet.class" width = "480" height = "320">
      <param name = "color" value = "blue">
      <param name = "squaresize" value = "30">
   </applet>
   <hr>
</html>

Note - 参数名称不区分大小写。

Note − Parameter names are not case sensitive.

Application Conversion to Applets

将图形 Java 应用程序(即使用 AWT、并且可以使用 Java 程序启动器启动的应用程序)很容易转换为可嵌入到网页中的小程序。

It is easy to convert a graphical Java application (that is, an application that uses the AWT and that you can start with the Java program launcher) into an applet that you can embed in a web page.

以下是将应用程序转换为小程序的具体步骤。

Following are the specific steps for converting an application to an applet.

  1. Make an HTML page with the appropriate tag to load the applet code.

  2. Supply a subclass of the JApplet class. Make this class public. Otherwise, the applet cannot be loaded.

  3. Eliminate the main method in the application. Do not construct a frame window for the application. Your application will be displayed inside the browser.

  4. Move any initialization code from the frame window constructor to the init method of the applet. You don’t need to explicitly construct the applet object. The browser instantiates it for you and calls the init method.

  5. Remove the call to setSize; for applets, sizing is done with the width and height parameters in the HTML file.

  6. Remove the call to setDefaultCloseOperation. An applet cannot be closed; it terminates when the browser exits.

  7. If the application calls setTitle, eliminate the call to the method. Applets cannot have title bars. (You can, of course, title the web page itself, using the HTML title tag.)

  8. Don’t call setVisible(true). The applet is displayed automatically.

Event Handling

小应用程序从 Container 类继承一组事件处理方法。Container 类定义了一些方法(如处理特定类型事件的 processKeyEvent 和 processMouseEvent)以及一个通用方法 processEvent。

Applets inherit a group of event-handling methods from the Container class. The Container class defines several methods, such as processKeyEvent and processMouseEvent, for handling particular types of events, and then one catch-all method called processEvent.

为了对事件做出反应,需要覆盖适当的事件特定方法。

In order to react to an event, an applet must override the appropriate event-specific method.

Example

import java.awt.event.MouseListener;
import java.awt.event.MouseEvent;
import java.applet.Applet;
import java.awt.Graphics;

public class ExampleEventHandling extends Applet implements MouseListener {
   StringBuffer strBuffer;

   public void init() {
      addMouseListener(this);
      strBuffer = new StringBuffer();
      addItem("initializing the apple ");
   }

   public void start() {
      addItem("starting the applet ");
   }

   public void stop() {
      addItem("stopping the applet ");
   }

   public void destroy() {
      addItem("unloading the applet");
   }

   void addItem(String word) {
      System.out.println(word);
      strBuffer.append(word);
      repaint();
   }

   public void paint(Graphics g) {
      // Draw a Rectangle around the applet's display area.
      g.drawRect(0, 0,
      getWidth() - 1,
      getHeight() - 1);

      // display the string inside the rectangle.
      g.drawString(strBuffer.toString(), 10, 20);
   }


   public void mouseEntered(MouseEvent event) {
   }
   public void mouseExited(MouseEvent event) {
   }
   public void mousePressed(MouseEvent event) {
   }
   public void mouseReleased(MouseEvent event) {
   }
   public void mouseClicked(MouseEvent event) {
      addItem("mouse clicked! ");
   }
}

现在,我们按如下方式调用此小应用程序 −

Now, let us call this applet as follows −

<html>
   <title>Event Handling</title>
   <hr>
   <applet code = "ExampleEventHandling.class"
      width = "300" height = "300">
   </applet>
   <hr>
</html>

最初,小应用程序将显示“初始化小应用程序。正在启动小应用程序。”然后,一旦您点击矩形内的某个位置,“鼠标已点击”也将显示出来。

Initially, the applet will display "initializing the applet. Starting the applet." Then once you click inside the rectangle, "mouse clicked" will be displayed as well.

Displaying Images

小应用程序可以显示 GIF、JPEG、BMP 等格式的图像。若要在小应用程序内显示图像,请使用 java.awt.Graphics 类提供的 drawImage() 方法。

An applet can display images of the format GIF, JPEG, BMP, and others. To display an image within the applet, you use the drawImage() method found in the java.awt.Graphics class.

以下是说明显示图像的所有步骤的一个示例 −

Following is an example illustrating all the steps to show images −

Example

import java.applet.*;
import java.awt.*;
import java.net.*;

public class ImageDemo extends Applet {
   private Image image;
   private AppletContext context;

   public void init() {
      context = this.getAppletContext();
      String imageURL = this.getParameter("image");
      if(imageURL == null) {
         imageURL = "java.jpg";
      }
      try {
         URL url = new URL(this.getDocumentBase(), imageURL);
         image = context.getImage(url);
      } catch (MalformedURLException e) {
         e.printStackTrace();
         // Display in browser status bar
         context.showStatus("Could not load image!");
      }
   }

   public void paint(Graphics g) {
      context.showStatus("Displaying image");
      g.drawImage(image, 0, 0, 200, 84, null);
      g.drawString("www.javalicense.com", 35, 100);
   }
}

现在,我们按如下方式调用此小应用程序 −

Now, let us call this applet as follows −

<html>
   <title>The ImageDemo applet</title>
   <hr>
   <applet code = "ImageDemo.class" width = "300" height = "200">
      <param name = "image" value = "java.jpg">
   </applet>
   <hr>
</html>

Playing Audio

小应用程序可以播放由 java.applet 包中的 AudioClip 接口表示的音频文件。AudioClip 接口有三个方法,包括 −

An applet can play an audio file represented by the AudioClip interface in the java.applet package. The AudioClip interface has three methods, including −

  1. public void play() − Plays the audio clip one time, from the beginning.

  2. public void loop() − Causes the audio clip to replay continually.

  3. public void stop() − Stops playing the audio clip.

要获取 AudioClip 对象,您必须调用 Applet 类的 getAudioClip() 方法。getAudioClip() 方法会立即返回,而不管 URL 是否解析为实际的音频文件。只有在尝试播放音频片段时才会下载音频文件。

To obtain an AudioClip object, you must invoke the getAudioClip() method of the Applet class. The getAudioClip() method returns immediately, whether or not the URL resolves to an actual audio file. The audio file is not downloaded until an attempt is made to play the audio clip.

以下是说明播放音频的所有步骤的一个示例 −

Following is an example illustrating all the steps to play an audio −

Example

import java.applet.*;
import java.awt.*;
import java.net.*;

public class AudioDemo extends Applet {
   private AudioClip clip;
   private AppletContext context;

   public void init() {
      context = this.getAppletContext();
      String audioURL = this.getParameter("audio");
      if(audioURL == null) {
         audioURL = "default.au";
      }
      try {
         URL url = new URL(this.getDocumentBase(), audioURL);
         clip = context.getAudioClip(url);
      } catch (MalformedURLException e) {
         e.printStackTrace();
         context.showStatus("Could not load audio file!");
      }
   }

   public void start() {
      if(clip != null) {
         clip.loop();
      }
   }

   public void stop() {
      if(clip != null) {
         clip.stop();
      }
   }
}

现在,我们按如下方式调用此小应用程序 −

Now, let us call this applet as follows −

<html>
   <title>The ImageDemo applet</title>
   <hr>
   <applet code = "ImageDemo.class" width = "0" height = "0">
      <param name = "audio" value = "test.wav">
   </applet>
   <hr>
</html>

可在您的 PC 上使用 test.wav 测试上述示例。

You can use test.wav on your PC to test the above example.

Java - Documentation Comments

Java 语言支持三种类型的注释 −

The Java language supports three types of comments −

Sr.No.

Comment & Description

1

/ text / The compiler ignores everything from /* to */.

2

//text The compiler ignores everything from // to the end of the line.

3

/* documentation / * This is a documentation comment and in general its called *doc comment. The JDK javadoc tool uses doc comments when preparing automatically generated documentation.

本章重点是解释 Javadoc。我们将了解如何使用 Javadoc 来生成 Java 代码的有用文档。

This chapter is all about explaining Javadoc. We will see how we can make use of Javadoc to generate useful documentation for Java code.

What is Javadoc?

Javadoc 是一个随 JDK 提供的工具,它用于从需要进行预定义格式文档的 Java 源代码生成 HTML 格式的 Java 代码文档。

Javadoc is a tool which comes with JDK and it is used for generating Java code documentation in HTML format from Java source code, which requires documentation in a predefined format.

以下是一个简单的示例,其中 /…./ 内部的是 Java 多行注释。类似地,// 前面的行是 Java 单行注释。

Following is a simple example where the lines inside /…./ are Java multi-line comments. Similarly, the line which preceeds // is Java single-line comment.

Example

/**
* The HelloWorld program implements an application that
* simply displays "Hello World!" to the standard output.
*
* @author  Zara Ali
* @version 1.0
* @since   2014-03-31
*/
public class HelloWorld {

   public static void main(String[] args) {
      // Prints Hello, World! on standard output.
      System.out.println("Hello World!");
   }
}

Output

Hello World!

您可以在说明部分中包含所需的 HTML 标记。例如,以下示例使用 <h1>…​</h1> 作为标题,<p> 用于创建段落分隔符 −

You can include required HTML tags inside the description part. For instance, the following example makes use of <h1>…​.</h1> for heading and <p> has been used for creating paragraph break −

Example

/**
* <h1>Hello, World!</h1>
* The HelloWorld program implements an application that
* simply displays "Hello World!" to the standard output.
* <p>
* Giving proper comments in your program makes it more
* user friendly and it is assumed as a high quality code.
*
*
* @author  Zara Ali
* @version 1.0
* @since   2014-03-31
*/
public class HelloWorld {

   public static void main(String[] args) {
      // Prints Hello, World! on standard output.
      System.out.println("Hello World!");
   }
}

Output

Hello World!

The javadoc Tags

javadoc 工具识别以下标记:

The javadoc tool recognizes the following tags −

Tag

Description

Syntax

@author

Adds the author of a class.

@author name-text

{@code}

Displays text in code font without interpreting the text as HTML markup or nested javadoc tags.

{@code text}

{@docRoot}

Represents the relative path to the generated document’s root directory from any generated page.

{@docRoot}

@deprecated

Adds a comment indicating that this API should no longer be used.

@deprecated deprecatedtext

@exception

Adds a Throws subheading to the generated documentation, with the classname and description text.

@exception class-name description

{@inheritDoc}

Inherits a comment from the nearest inheritable class or implementable interface.

Inherits a comment from the immediate surperclass.

{@link}

Inserts an in-line link with the visible text label that points to the documentation for the specified package, class, or member name of a referenced class.

{@link package.class#member label}

{@linkplain}

Identical to {@link}, except the link’s label is displayed in plain text than code font.

{@linkplain package.class#member label}

@param

Adds a parameter with the specified parameter-name followed by the specified description to the "Parameters" section.

@param parameter-name description

@return

Adds a "Returns" section with the description text.

@return description

@see

Adds a "See Also" heading with a link or text entry that points to reference.

@see reference

@serial

Used in the doc comment for a default serializable field.

@serial field-description

include

exclude

@serialData

Documents the data written by the writeObject( ) or writeExternal( ) methods.

@serialData data-description

@serialField

Documents an ObjectStreamField component.

@serialField field-name field-type field-description

@since

Adds a "Since" heading with the specified since-text to the generated documentation.

@since release

@throws

The @throws and @exception tags are synonyms.

@throws class-name description

{@value}

When {@value} is used in the doc comment of a static field, it displays the value of that constant.

{@value package.class#field}

@version

Example

下述程序使用文档注释中可用的少数几个重要标记。您可以根据您的要求使用其他标记。

Following program uses few of the important tags available for documentation comments. You can make use of other tags based on your requirements.

有关 AddNum 类的文档会生成在 HTML 文件 AddNum.html 中,但同时也会创建具有名称 index.html 的主文件。

The documentation about the AddNum class will be produced in HTML file AddNum.html but at the same time a master file with a name index.html will also be created.

import java.io.*;

/**
* <h1>Add Two Numbers!</h1>
* The AddNum program implements an application that
* simply adds two given integer numbers and Prints
* the output on the screen.
* <p>
* <b>Note:</b> Giving proper comments in your program makes it more
* user friendly and it is assumed as a high quality code.
*
* @author  Zara Ali
* @version 1.0
* @since   2014-03-31
*/
public class AddNum {
   /**
   * This method is used to add two integers. This is
   * a the simplest form of a class method, just to
   * show the usage of various javadoc Tags.
   * @param numA This is the first paramter to addNum method
   * @param numB  This is the second parameter to addNum method
   * @return int This returns sum of numA and numB.
   */
   public int addNum(int numA, int numB) {
      return numA + numB;
   }

   /**
   * This is the main method which makes use of addNum method.
   * @param args Unused.
   * @return Nothing.
   * @exception IOException On input error.
   * @see IOException
   */

   public static void main(String args[]) throws IOException {
      AddNum obj = new AddNum();
      int sum = obj.addNum(10, 20);

      System.out.println("Sum of 10 and 20 is :" + sum);
   }
}

让我们编译并运行上述程序,这将生成以下结果 −

Let us compile and run the above program, this will produce the following result −

Sum of 10 and 20 is :30

现在,使用 javadoc 实用程序按如下方式处理上述 AddNum.java 文件 -

Now, process the above AddNum.java file using javadoc utility as follows −

$ javadoc AddNum.java
Loading source file AddNum.java...
Constructing Javadoc information...
Standard Doclet version 1.7.0_51
Building tree for all the packages and classes...
Generating /AddNum.html...
AddNum.java:36: warning - @return tag cannot be used in method with void return type.
Generating /package-frame.html...
Generating /package-summary.html...
Generating /package-tree.html...
Generating /constant-values.html...
Building index for all the packages and classes...
Generating /overview-tree.html...
Generating /index-all.html...
Generating /deprecated-list.html...
Building index for all classes...
Generating /allclasses-frame.html...
Generating /allclasses-noframe.html...
Generating /index.html...
Generating /help-doc.html...
1 warning
$

您可以在此处查看所有生成的文档 − AddNum。如果您正在使用 JDK 1.7,则 javadoc 不会生成很棒的 stylesheet.css,因此我们建议您从以下位置下载并使用标准样式表

You can check all the generated documentation here − AddNum. If you are using JDK 1.7 then javadoc does not generate a great stylesheet.css, so we suggest to download and use standard stylesheet from