Bình luận trong Java

Chú thích trong Java , cũng như trong hầu hết các ngôn ngữ lập trình khác, là các ký tự bị bỏ qua trong quá trình thực thi chương trình. Do đó, bạn có thể thêm bao nhiêu nhận xét vào chương trình nếu cần mà không sợ tăng kích thước của nó. Chú thích được sử dụng để mô tả sự phức tạp của một khối mã, phương thức hoặc lớp cụ thể. Bạn cũng có thể sử dụng chúng nếu muốn để lại lời nhắn cho những lập trình viên sẽ làm việc với mã này trong tương lai. Hoặc cho ghi chú của riêng bạn.

Cách làm nổi bật nhận xét

Java có hai cách để đánh dấu các bình luận trong văn bản.

Nhận xét thực hiện (nhận xét mã)

1. Bình luận một dòng

   Đây là loại bình luận được sử dụng phổ biến nhất. Để viết bình luận như vậy, bạn cần sử dụng hai dấu gạch chéo lên //. Trong trường hợp này, chú thích bắt đầu ngay sau các ký tự //và tiếp tục cho đến hết dòng.

   System.out.println("Hello, Java world!");
   // наш комментарий

2. Bình luận một khối văn bản

   Nếu bạn cần bình luận dài hơn, bạn có thể bắt đầu mỗi dòng bằng các ký hiệu. Mặc dù sẽ thuận tiện hơn khi giới hạn các khối nhận xét ở các dấu phân cách /*và */.

   /*
    Пример простой программы на Java
   */
   
   public class SampleProgram
   {
    public static void main (String [] args)
    {
    System.out.println("Hello, Java world!");
    }
   }

   Chúng ta không nên quên rằng các nhận xét, được phân tách bằng các ký hiệu, /*không thể */lồng nhau trong ngôn ngữ Java. Điều này có nghĩa là một đoạn mã không thể bị vô hiệu hóa chỉ bằng cách bao quanh nó bằng /*và , vì mã bị vô hiệu hóa có thể chứa */các dấu phân cách /*và */.

Ghi lại nhận xét

Để ghi lại các phương thức, biến hoặc lớp, một phương pháp đánh dấu văn bản đặc biệt được sử dụng. Việc này được thực hiện bằng cách sử dụng /**và */. Trong trường hợp này, mỗi dòng văn bản nhận xét bắt đầu bằng *.Nếu một phương thức được ghi lại, thông thường sẽ mô tả các đối số và giá trị trả về của nó.

/**
* Метод возвращает максимальное meaning
* из трех переданных аргументов
* @param a - первый параметр
* @param b - второй параметр
* @param c - третий параметр
* @return - максимальный из параметров
*/
public int max(int a, int b, int c) {
   return Math.max(Math.max(a, b), c);
}

Còn gì để đọc nữa? Ví dụ: tài liệu này: Nhận xét trong Java: không phải mọi thứ đều đơn giản như vậy . Hoặc một bài giảng từ nhiệm vụ Java Syntax Pro về nhận xét.