Deep Java

Thành thạo các đối số dòng lệnh trong Java — Từ cơ bản đến các mẫu thực tiễn, an toàn

Biên dịch và chạy chương trình
目次

1. Giới thiệu

Mục đích của chương này

Trong Java, đối số dòng lệnh là một tính năng cơ bản cho phép chương trình nhận đầu vào bên ngoài tại thời gian chạy và thay đổi hành vi tương ứng. Bài viết này hướng dẫn bạn từng bước từ ý nghĩa của String[] args đến các mẫu thiết kế thực tiễn. Trong chương này, chúng ta sẽ làm rõ những gì bạn có thể làm và tại sao nó quan trọng.

Các đối số dòng lệnh là gì?

Một ứng dụng Java thường bắt đầu bằng phương thức main có chữ ký sau:

public class App {
    public static void main(String[] args) {
        // args is an array of strings passed at runtime
    }
}

Tham số args là một mảng String lưu trữ các giá trị được gắn vào lệnh khởi động. Ví dụ:

javac App.java
java App Tokyo 2025 debug

Trong trường hợp này, args chứa ["Tokyo", "2025", "debug"].
Nếu không có đối số nào được cung cấp, args.length sẽ bằng 0.

Trường hợp sử dụng

  • Chuyển đổi môi trường hoặc mục tiêu — chẳng hạn chế độ sản xuất/kiểm thử, mã vùng, ngôn ngữ, hoặc mức độ log.
  • Chỉ định mục tiêu xử lý từ bên ngoài — tên tệp, thư mục, URL, hoặc danh sách ID.
  • Tự động hoá và xử lý hàng loạt — truyền các tham số như khoảng thời gian ngày tháng từ cron job hoặc pipeline CI/CD.

Tất cả những điều này cho phép thay đổi hành vi không cần biên dịch lại, làm cho đối số dòng lệnh trở nên lý tưởng cho việc tích hợp với các script shell và bộ lập lịch công việc như cron.

Các yếu tố thiết kế quan trọng

  • Phân biệt giữa đối số bắt buộc và tùy chọn — nếu một đối số bắt buộc bị thiếu, hiển thị trợ giúp hoặc thoát với mã trạng thái phù hợp.
  • Xác thực sớm — chuyển đổi sang kiểu số hoặc ngày càng sớm càng tốt, và cung cấp thông báo rõ ràng cho đầu vào không hợp lệ.
  • Thiết kế giá trị mặc định — cung cấp các giá trị an toàn để chương trình vẫn chạy được ngay cả khi các đối số tùy chọn bị bỏ qua.
  • Duy trì tính đọc được và bảo trì — tránh việc truy cập mảng thô rải rác; phân tích đối số thành các đối tượng có cấu trúc (DTO hoặc lớp cấu hình) trước khi sử dụng.

Lựa chọn giữa tệp cấu hình và biến môi trường

  • Đối số dòng lệnh: Tốt nhất cho các ghi đè tạm thời hoặc các công tắc đặc thù cho từng công việc (được xem là cài đặt cục bộ có ưu tiên cao nhất).
  • Biến môi trường: Thích hợp cho bí mật hoặc các cài đặt phụ thuộc vào môi trường như endpoint.
  • Tệp cấu hình (properties/JSON/YAML): Lý tưởng khi quản lý nhiều mục một cách có hệ thống để tái sử dụng và kiểm soát phiên bản.

Trong thực tế, thường kết hợp cả ba — tệp cấu hình + biến môi trường + đối số — và để các đối số có độ ưu tiên cao nhất trong việc ghi đè cài đặt.

Ví dụ tối thiểu (Liệt kê tất cả các đối số)

public class ArgsEcho {
    public static void main(String[] args) {
        if (args.length == 0) {
            System.out.println("No arguments were provided.");
            System.out.println("Example: java ArgsEcho input.txt debug");
            return;
        }
        System.out.println("Received arguments:");
        for (int i = 0; i < args.length; i++) {
            System.out.printf("args[%d] = %s%n", i, args[i]);
        }
    }
}

Những gì tiếp theo (Lộ trình)

  • Các thao tác cơ bản — kiểm tra độ dài, truy cập phần tử cho String[] args
  • Chuyển đổi kiểu — xử lý int/double/boolean và an toàn ngoại lệ
  • Phân tích kiểu tùy chọn — ví dụ, -v , --help , --mode=prod
  • Cấu hình IDE và truyền đối số trong quá trình kiểm thử
  • Xử lý lỗi và cân nhắc bảo mật — đầu vào không hợp lệ, ngoại lệ
  • Ví dụ thực tiễn — xử lý tệp, chuyển đổi chế độ, kiểm soát log

Đầu tiên, hãy nhớ nguyên tắc này: Tất cả các đối số đều được nhận dưới dạng chuỗi và phải được chuyển đổi và xác thực một cách an toàn trước khi sử dụng. Các chương tiếp theo sẽ giải thích cú pháp và các mẫu phổ biến với các ví dụ mã chi tiết.

2. Cách nhận đối số dòng lệnh trong Java

Cấu trúc cơ bản

Các đối số dòng lệnh trong Java được xử lý như một mảng các chuỗi (String[] args) được truyền vào phương thức main. Mỗi token ngăn cách bằng dấu cách được nhập sau tên lớp trong lệnh thực thi sẽ trở thành một phần tử trong mảng.

public class Example {
    public static void main(String[] args) {
        System.out.println("Number of arguments: " + args.length);
        for (String arg : args) {
            System.out.println(arg);
        }
    }
}

Khi bạn thực thi chương trình như sau:

javac Example.java
java Example apple orange banana

Kết quả sẽ là:

Number of arguments: 3
apple
orange
banana

Truy cập các đối số cụ thể

Mỗi phần tử có thể được truy cập bằng chỉ mục của nó, bắt đầu từ 0. Tuy nhiên, luôn kiểm tra args.length để tránh ArrayIndexOutOfBoundsException.

public class AccessExample {
    public static void main(String[] args) {
        if (args.length < 2) {
            System.out.println("Usage: java AccessExample <name> <age>");
            return;
        }

        String name = args[0];
        String age  = args[1];
        System.out.println("Name: " + name);
        System.out.println("Age: " + age);
    }
}

Khi thực thi bằng java AccessExample Alice 30, kết quả là:

Name: Alice
Age: 30

Xử lý các đối số thiếu một cách an toàn

Vì tất cả các giá trị trong args đều là chuỗi, chúng có thể bị thiếu, sai định dạng, hoặc không thể chuyển đổi sang kiểu mong muốn. Thực hành tốt là kiểm tra tính hợp lệ trước khi sử dụng chúng.

if (args.length == 0) {
    System.out.println("No arguments provided. Please specify input parameters.");
    System.exit(1); // Exit with an error code
}

Bạn có thể sử dụng System.exit(int) để chỉ ra trạng thái thoát. Theo quy ước, 0 có nghĩa là thành công, và các giá trị khác 0 (như 1 hoặc 2) đại diện cho các loại lỗi khác nhau.

Dấu ngoặc kép và khoảng trắng

Các đối số được ngăn cách bằng dấu cách sẽ được coi là các giá trị riêng biệt. Nếu bạn cần bao gồm khoảng trắng trong một đối số duy nhất, hãy đặt nó trong dấu ngoặc kép:

java Example "New York" Japan

Điều này sẽ cho ra:

args[0] = New York
args[1] = Japan

Khi không có đối số nào được cung cấp

Nếu không có đối số nào được cung cấp, args.length bằng 0. Bạn có thể sử dụng điều này để phân nhánh logic của mình cho phù hợp, ví dụ:

if (args.length == 0) {
    System.out.println("Running in interactive mode...");
} else {
    System.out.println("Running with parameters...");
}

Mẫu này đặc biệt hữu ích trong các công cụ hỗ trợ cả chế độ tương tác và thực thi hàng loạt.

3. Chuyển đổi dữ liệu và Xử lý lỗi

Tất cả các đối số dòng lệnh được truyền dưới dạng chuỗi (String). Do đó, để sử dụng chúng như số, boolean hoặc các kiểu khác, bạn cần chuyển đổi chúng một cách rõ ràng. Chương này giải thích cách chuyển đổi an toàn các kiểu dữ liệu và xử lý các lỗi có thể xảy ra.

Chuyển đổi chuỗi thành số nguyên và số thực

Các phương thức Integer.parseInt() và Double.parseDouble() được sử dụng để chuyển đổi giá trị chuỗi thành các kiểu số. Nếu đầu vào không thể phân tích thành số, một NumberFormatException sẽ được ném.

public class ParseExample {
    public static void main(String[] args) {
        if (args.length < 2) {
            System.out.println("Usage: java ParseExample <price> <quantity>");
            return;
        }

        try {
            double price = Double.parseDouble(args[0]);
            int quantity = Integer.parseInt(args[1]);
            System.out.println("Total: " + (price * quantity));
        } catch (NumberFormatException e) {
            System.out.println("Error: Please enter numeric values only.");
        }
    }
}

Ví dụ thực thi:

java ParseExample 120.5 3
Total: 361.5

Xử lý Boolean

Để phân tích các cờ boolean như “chế độ gỡ lỗi” hoặc “chi tiết”, bạn có thể sử dụng Boolean.parseBoolean(). Nó trả về true chỉ khi đối số bằng “true” (không phân biệt chữ hoa chữ thường).

boolean debug = false;
if (args.length > 0) {
    debug = Boolean.parseBoolean(args[0]);
}

if (debug) {
    System.out.println("Debug mode enabled");
} else {
    System.out.println("Debug mode disabled");
}

Ví dụ thực thi:

java Example true
Debug mode enabled

java Example false
Debug mode disabled

Chuyển đổi an toàn với giá trị mặc định

Thực hành tốt là cung cấp giá trị mặc định trong trường hợp đầu vào bị thiếu hoặc không hợp lệ. Điều này ngăn ngừa lỗi thời gian chạy và cải thiện trải nghiệm người dùng.

public static int parseIntOrDefault(String s, int defaultValue) {
    try {
        return Integer.parseInt(s);
    } catch (Exception e) {
        return defaultValue;
    }
}

Mẫu này cũng có thể mở rộng cho các số thực hoặc ngày tháng, tùy theo nhu cầu của bạn.

Bắt và báo cáo lỗi một cách nhẹ nhàng

Khi xử lý đầu vào người dùng, thông báo lỗi nên rõ ràng và hữu ích. Thay vì chỉ in ra stack trace, hãy cung cấp hướng dẫn sử dụng đúng.

try {
    int age = Integer.parseInt(args[0]);
    if (age < 0) throw new IllegalArgumentException("Age cannot be negative");
    System.out.println("Age: " + age);
} catch (NumberFormatException e) {
    System.err.println("Error: Please enter a valid number for age.");
} catch (IllegalArgumentException e) {
    System.err.println(e.getMessage());
}

Sử dụng System.err.println() sẽ đưa thông báo lỗi tới luồng lỗi chuẩn, cho phép tách biệt chúng khỏi đầu ra bình thường trong log hoặc pipeline.

Tùy chọn: Sử dụng lớp Optional của Java

Để tránh kiểm tra null và cải thiện khả năng đọc mã, hãy cân nhắc dùng Optional<T> cho việc phân tích đối số. Ví dụ:

import java.util.Optional;

public class OptionalExample {
    public static void main(String[] args) {
        Optional<String> arg0 = (args.length > 0) ? Optional.of(args[0]) : Optional.empty();
        String message = arg0.orElse("default");
        System.out.println("Argument: " + message);
    }
}

Điều này đảm bảo chương trình chạy an toàn ngay cả khi không có đối số nào được cung cấp.

Tóm tắt: Để xây dựng các chương trình dòng lệnh mạnh mẽ, luôn giả định rằng đầu vào người dùng có thể bị thiếu hoặc sai định dạng. Kết hợp việc phân tích, xác thực và thông báo lỗi có ý nghĩa để đảm bảo tính ổn định.

4. Xử lý các đối số kiểu tùy chọn

Khi các chương trình Java của bạn phát triển, việc xử lý các đối số dạng -h, --help hoặc --mode=prod trở nên thiết yếu. Các đối số kiểu tùy chọn này làm cho chương trình của bạn dễ đọc hơn và thân thiện với người dùng, đặc biệt đối với các tiện ích dòng lệnh hoặc script tự động.

Các tùy chọn ngắn và dài

Các tùy chọn thường xuất hiện ở hai dạng:

  • Tùy chọn ngắn — bắt đầu bằng một dấu gạch ngang, chẳng hạn -v hoặc -h .
  • Tùy chọn dài — bắt đầu bằng hai dấu gạch ngang, chẳng hạn --help hoặc --mode=prod .

Bạn có thể tự phân tích chúng bằng các thao tác chuỗi như startsWith() và split().

public class OptionExample {
    public static void main(String[] args) {
        boolean help = false;
        String mode = "dev";

        for (String arg : args) {
            if (arg.equals("-h") || arg.equals("--help")) {
                help = true;
            } else if (arg.startsWith("--mode=")) {
                mode = arg.split("=", 2)[1];
            }
        }

        if (help) {
            System.out.println("Usage: java OptionExample [--mode=<mode>] [-h|--help]");
            return;
        }

        System.out.println("Mode: " + mode);
    }
}

Ví dụ thực thi:

java OptionExample
Mode: dev

java OptionExample --mode=prod
Mode: prod

java OptionExample -h
Usage: java OptionExample [--mode=<mode>] [-h|--help]

Kết hợp cờ và giá trị

Đôi khi bạn cần xử lý các cờ đi kèm với giá trị riêng, như --input data.txt. Trong những trường hợp này, bạn có thể duyệt qua các đối số bằng một chỉ mục và đọc giá trị tiếp theo một cách an toàn.

public class InputExample {
    public static void main(String[] args) {
        String inputFile = null;

        for (int i = 0; i < args.length; i++) {
            if (args[i].equals("--input") && i + 1 < args.length) {
                inputFile = args[i + 1];
            }
        }

        if (inputFile == null) {
            System.out.println("Please specify an input file using --input <filename>");
            return;
        }

        System.out.println("Processing file: " + inputFile);
    }
}

Ví dụ thực thi:

java InputExample --input report.csv
Processing file: report.csv

Kết hợp Nhiều Tùy chọn

Các công cụ thực tế thường chấp nhận nhiều tùy chọn — ví dụ, --mode=prod --debug --log-level=2. Để quản lý chúng một cách sạch sẽ, hãy cân nhắc phân tích tất cả các tùy chọn thành một đối tượng cấu hình.

class Config {
    String mode = "dev";
    boolean debug = false;
    int logLevel = 1;
}

public class ConfigExample {
    public static void main(String[] args) {
        Config cfg = new Config();

        for (String arg : args) {
            if (arg.startsWith("--mode=")) {
                cfg.mode = arg.split("=", 2)[1];
            } else if (arg.equals("--debug")) {
                cfg.debug = true;
            } else if (arg.startsWith("--log-level=")) {
                try {
                    cfg.logLevel = Integer.parseInt(arg.split("=", 2)[1]);
                } catch (NumberFormatException e) {
                    System.err.println("Invalid log level. Using default value: 1");
                }
            }
        }

        System.out.println("Mode: " + cfg.mode);
        System.out.println("Debug: " + cfg.debug);
        System.out.println("Log Level: " + cfg.logLevel);
    }
}

Sử dụng Apache Commons CLI (Đề xuất)

Đối với các dự án lớn hơn, việc tự phân tích các đối số một cách thủ công trở nên dễ gây lỗi. Thư viện Apache Commons CLI cung cấp một cách chuẩn hoá để định nghĩa và xử lý các tùy chọn dòng lệnh với các thông báo trợ giúp và xác thực.

import org.apache.commons.cli.*;

public class CLIExample {
    public static void main(String[] args) throws Exception {
        Options options = new Options();
        options.addOption("h", "help", false, "Show help message");
        options.addOption("m", "mode", true, "Execution mode (dev/prod)");

        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = parser.parse(options, args);

        if (cmd.hasOption("h")) {
            HelpFormatter formatter = new HelpFormatter();
            formatter.printHelp("CLIExample", options);
            return;
        }

        String mode = cmd.getOptionValue("m", "dev");
        System.out.println("Mode: " + mode);
    }
}

Cách tiếp cận này tự động hỗ trợ việc tạo trợ giúp, xác thực đầu vào và tách mã rõ ràng hơn giữa phần định nghĩa và logic.

Tóm tắt Các Thực hành Tốt nhất

  • Hỗ trợ cả cờ ngắn ( -h ) và dài ( --help ).
  • Sử dụng startsWith() và split("=") để phân tích đơn giản.
  • Sử dụng các lớp cấu hình để cải thiện khả năng bảo trì.
  • Áp dụng các thư viện như Apache Commons CLI cho các triển khai có khả năng mở rộng.
  • Luôn cung cấp --help hoặc đầu ra hướng dẫn sử dụng để rõ ràng.

Bằng cách thiết kế việc phân tích các đối số của bạn theo cách này, bạn có thể làm cho các công cụ Java của mình trở nên trực quan hơn, dự đoán được và dễ bảo trì hơn — giống như các ứng dụng dòng lệnh chuyên nghiệp.

5. Cài đặt và Kiểm tra Đối số Dòng lệnh trong IDEs

Khi phát triển các ứng dụng Java, bạn thường muốn kiểm tra cách chương trình của mình hoạt động với các đối số dòng lệnh khác nhau — mà không cần chạy trực tiếp từ terminal. Phần này giải thích cách cấu hình đối số trong các IDE phổ biến như Eclipse và IntelliJ IDEA.

Cài đặt Đối số trong Eclipse

Trong Eclipse, bạn có thể cấu hình đối số thông qua hộp thoại “Run Configurations”. Thực hiện các bước sau:

  • 1️⃣ Mở tệp Java của bạn và nhấp chuột phải vào trình soạn thảo.
  • 2️⃣ Chọn Run As → Run Configurations… .
  • 3️⃣ Trong hộp thoại, chọn lớp của bạn dưới “Java Application.”
  • 4️⃣ Nhấp vào thẻ Arguments.
  • 5️⃣ Trong ô Program arguments, nhập các đối số mong muốn, cách nhau bằng dấu cách.

Ví dụ:

Tokyo 2025 debug

Khi bạn chạy chương trình, Eclipse sẽ tự động truyền các đối số này vào String[] args.

Mẹo: Bạn có thể tạo nhiều cấu hình — ví dụ, một cho “chế độ sản xuất” và một cho “chế độ gỡ lỗi” — và chuyển đổi giữa chúng một cách dễ dàng.

Đặt Đối Số trong IntelliJ IDEA

Trong IntelliJ IDEA, quy trình cũng tương tự đơn giản:

  • 1️⃣ Nhấp vào menu thả xuống bên cạnh nút Run (góc trên bên phải).
  • 2️⃣ Chọn Edit Configurations… .
  • 3️⃣ Trong cửa sổ “Run/Debug Configurations”, tìm lớp Java của bạn dưới “Application.”
  • 4️⃣ Trong trường Program arguments, nhập các đối số của bạn giống như khi bạn gõ trên dòng lệnh.

Ví dụ:

--mode=prod --debug true

Nhấn Apply rồi Run. IntelliJ sẽ khởi chạy chương trình của bạn với các tham số đó được truyền vào mảng args.

Kiểm Tra Nhiều Mẫu Nhanh Chóng

Khi kiểm thử tự động hoá hoặc công cụ batch, bạn có thể tiết kiệm thời gian bằng cách đăng ký nhiều cấu hình chạy với các bộ đối số khác nhau — ví dụ:

  • config-dev : --mode=dev --debug
  • config-prod : --mode=prod --log-level=2
  • config-local : input.txt output.txt

Điều này cho phép chuyển đổi chỉ bằng một cú nhấp chuột giữa các điều kiện kiểm thử mà không cần sửa đổi mã nguồn hoặc lệnh terminal.

Truyền Đối Số Khi Thực Hiện Kiểm Thử JUnit

Nếu bạn cần xác minh việc xử lý đối số trong các kiểm thử tự động, bạn có thể mô phỏng đối số bằng cách truyền rõ ràng một String[] vào phương thức main của bạn từ trong JUnit.

import org.junit.jupiter.api.Test;

public class ArgsTest {
    @Test
    void testArguments() {
        String[] args = {"--mode=prod", "--debug"};
        MyApp.main(args);
    }
}

Mẫu này cho phép bạn kiểm thử logic chương trình trong cùng môi trường JVM với mã ứng dụng thông thường, hỗ trợ tự động hoá CI/CD đầy đủ.

Những Sai Lầm Thường Gặp Khi Kiểm Thử Đối Số trong IDE

  • 🧩 Quên lưu cấu hình trước khi chạy (đặc biệt trong Eclipse).
  • 🧩 Gõ sai dấu cách — mỗi dấu cách tách các đối số trừ khi được bao trong dấu ngoặc kép.
  • 🧩 Không chạy lại sau khi chỉnh sửa đối số — một số IDE lưu bộ nhớ đệm cấu hình cũ.
  • 🧩 Mong đợi các biến môi trường thay đổi tự động (cần cấu hình chúng riêng trong cài đặt IDE).

Bằng cách nắm vững các cài đặt đối số trong IDE, bạn có thể mô phỏng hành vi giống môi trường sản xuất trên máy cục bộ và giảm thiểu các vấn đề chạy không mong muốn.

6. Xử Lý Lỗi và Thiết Kế Bảo Mật

Khi nhận đầu vào từ dòng lệnh, chương trình Java của bạn phải xử lý các đối số không hợp lệ, bất ngờ hoặc độc hại một cách nhẹ nhàng. Phần này đề cập đến các thực hành xác thực an toàn và các nguyên tắc bảo mật ngăn ngừa lỗi hệ thống hoặc lạm dụng.

Xác Thực Trước Khi Sử Dụng

Không bao giờ giả định đầu vào của người dùng là hợp lệ. Luôn xác thực các đối số trước khi sử dụng chúng trong tính toán, thao tác file hoặc gọi hệ thống. Các xác thực thường gặp bao gồm:

  • Kiểm tra số lượng đối số (args.length).
  • Xác minh định dạng (ví dụ: số, boolean, URL, hoặc ngày).
  • Xác nhận đường dẫn file tồn tại và có thể truy cập.
  • Từ chối ký tự không hợp lệ có thể dẫn đến tấn công injection hoặc path traversal.

Ví dụ: xác thực phạm vi nhập số trước khi sử dụng:

try {
    int threads = Integer.parseInt(args[0]);
    if (threads < 1 || threads > 64) {
        throw new IllegalArgumentException("Thread count must be between 1 and 64.");
    }
    System.out.println("Using " + threads + " threads.");
} catch (Exception e) {
    System.err.println("Error: " + e.getMessage());
}

Ngăn Ngừa Lạm Dụng Đường Dẫn File

Khi làm việc với các đối số đại diện cho đường dẫn file, đảm bảo người dùng không thể di chuyển ra ngoài các thư mục dự định bằng cách sử dụng ../ hoặc symbolic links. Ví dụ:

import java.nio.file.*;

Path baseDir = Paths.get("/var/app/data");
Path inputPath = baseDir.resolve(args[0]).normalize();

if (!inputPath.startsWith(baseDir)) {
    throw new SecurityException("Access outside of permitted directory is not allowed.");
}

Điều này ngăn chặn các cuộc tấn công path traversal nơi người dùng cố gắng truy cập các tệp nhạy cảm bên ngoài khu vực được chỉ định.

Tránh Thực Thi Các Lệnh Tùy Ý

Các đối số không bao giờ nên được truyền trực tiếp đến các lệnh hệ thống hoặc quy trình bên ngoài mà không được làm sạch. Nếu không, chương trình của bạn có thể trở nên dễ bị tổn thương với command injection.

// ❌ Dangerous example (do not use)
Runtime.getRuntime().exec("cat " + args[0]);

// ✅ Safe alternative using ProcessBuilder
ProcessBuilder pb = new ProcessBuilder("cat", args[0]);
pb.redirectErrorStream(true);
pb.start();

API ProcessBuilder xử lý từng đối số riêng biệt, ngăn chặn việc diễn giải shell độc hại.

Báo Cáo Lỗi Và Mã Thoát

Đối với các công cụ chuyên nghiệp, hãy thiết kế các mã thoát rõ ràng và thông báo lỗi để giúp người dùng hiểu những gì đã xảy ra sai. Phân loại ví dụ:

  • 0 — Thực thi thành công
  • 1 — Lỗi đầu vào hoặc đối số không hợp lệ
  • 2 — Thiếu tệp hoặc tài nguyên
  • 3 — Bị từ chối quyền
  • 99 — Ngoại lệ không xác định hoặc không được xử lý

Ví dụ triển khai:

try {
    // business logic
} catch (IllegalArgumentException e) {
    System.err.println("Invalid argument: " + e.getMessage());
    System.exit(1);
} catch (SecurityException e) {
    System.err.println("Permission error: " + e.getMessage());
    System.exit(3);
} catch (Exception e) {
    e.printStackTrace();
    System.exit(99);
}

Làm Sạch Nhật Ký Và Đầu Ra Lỗi

Khi ghi nhật ký các đối số do người dùng cung cấp, không bao gồm thông tin nhạy cảm như mật khẩu, token, hoặc dữ liệu cá nhân. Ví dụ:

String password = args[0];
// ❌ Don't log this directly
// System.out.println("Password: " + password);

// ✅ Use placeholders or masked output
System.out.println("Password provided: [REDACTED]");

Điều này giúp ngăn chặn rò rỉ dữ liệu ngẫu nhiên trong nhật ký hoặc đầu ra console, đặc biệt trong môi trường chia sẻ hoặc đường ống CI/CD.

Tóm Tắt Lập Trình Phòng Thủ

  • Luôn xác thực đối số trước khi sử dụng.
  • Chuẩn hóa và kiểm tra đường dẫn để ngăn chặn directory traversal.
  • Không bao giờ nối đầu vào người dùng vào các lệnh shell.
  • Thiết kế mã thoát rõ ràng để tương thích với tự động hóa.
  • Che giấu dữ liệu nhạy cảm trong nhật ký và thông báo.
  • Thất bại nhanh nhưng thất bại an toàn — tránh chương trình sập làm lộ stack traces.

Bằng cách áp dụng các kỹ thuật phòng thủ này, các ứng dụng Java của bạn sẽ vẫn mạnh mẽ, an toàn và chuyên nghiệp — ngay cả khi được thực thi trong môi trường thời gian chạy không thể dự đoán.

7. Ví Dụ Thực Tế — Xử Lý Tệp, Chuyển Đổi Chế Độ, Và Kiểm Soát Nhật Ký

Sau khi hiểu cú pháp và các thực hành tốt nhất để xử lý đối số, đã đến lúc khám phá các trường hợp sử dụng thực tế. Phần này giới thiệu ba mẫu điển hình: hoạt động tệp, chuyển đổi chế độ môi trường, và kiểm soát nhật ký động. Những điều này phổ biến trong các ứng dụng thế giới thực và quy trình tự động hóa.

Ví Dụ 1: Chương Trình Xử Lý Tệp

Trong nhiều kịch bản tự động hóa, các đối số dòng lệnh được sử dụng để chỉ định đường dẫn tệp cho đầu vào và đầu ra. Dưới đây là một ví dụ đơn giản sao chép nội dung của một tệp sang tệp khác:

import java.nio.file.*;
import java.io.IOException;

public class FileCopy {
    public static void main(String[] args) {
        if (args.length < 2) {
            System.out.println("Usage: java FileCopy <source> <destination>");
            System.exit(1);
        }

        Path src = Paths.get(args[0]);
        Path dst = Paths.get(args[1]);

        try {
            Files.copy(src, dst, StandardCopyOption.REPLACE_EXISTING);
            System.out.println("File copied successfully: " + dst);
        } catch (IOException e) {
            System.err.println("File copy failed: " + e.getMessage());
            System.exit(2);
        }
    }
}

Ví dụ thực thi:

java FileCopy input.txt backup/input_copy.txt

Bằng cách tham số hóa đường dẫn tệp, bạn có thể tái sử dụng chương trình này trong các pipeline tự động hóa, script sao lưu, hoặc công việc cron.

Ví dụ 2: Chuyển đổi Giữa Các Chế Độ (Phát Triển / Sản Xuất)

Các ứng dụng thường hoạt động khác nhau tùy thuộc vào môi trường của chúng — ví dụ, sử dụng các cơ sở dữ liệu hoặc điểm cuối API khác nhau. Bạn có thể chuyển đổi hành vi một cách động bằng cách sử dụng đối số như --mode=prod.

public class ModeSwitch {
    public static void main(String[] args) {
        String mode = "dev"; // default mode

        for (String arg : args) {
            if (arg.startsWith("--mode=")) {
                mode = arg.split("=", 2)[1];
            }
        }

        switch (mode) {
            case "dev":
                System.out.println("Running in Development Mode");
                break;
            case "prod":
                System.out.println("Running in Production Mode");
                break;
            case "test":
                System.out.println("Running in Test Mode");
                break;
            default:
                System.err.println("Unknown mode: " + mode);
                System.exit(1);
        }
    }
}

Các ví dụ thực thi:

java ModeSwitch --mode=dev
Running in Development Mode

java ModeSwitch --mode=prod
Running in Production Mode

Thiết kế này cho phép bạn quản lý nhiều cấu hình một cách gọn gàng và tránh mã hóa cứng logic cụ thể cho môi trường.

Ví dụ 3: Mức Độ Nhật Ký và Kiểm Soát Gỡ Lỗi

Mức độ ghi nhật ký thường được kiểm soát qua các đối số dòng lệnh, cho phép chẩn đoán linh hoạt mà không cần thay đổi mã.

public class LogControl {
    public static void main(String[] args) {
        int logLevel = 1; // 1: normal, 2: verbose, 3: debug

        for (String arg : args) {
            if (arg.startsWith("--log=")) {
                try {
                    logLevel = Integer.parseInt(arg.split("=", 2)[1]);
                } catch (NumberFormatException e) {
                    System.err.println("Invalid log level. Using default: 1");
                }
            }
        }

        if (logLevel >= 3) System.out.println("[DEBUG] Debug information enabled");
        if (logLevel >= 2) System.out.println("[INFO] Detailed information shown");
        System.out.println("[NORMAL] Application started");
    }
}

Ví dụ thực thi:

java LogControl --log=3
[DEBUG] Debug information enabled
[INFO] Detailed information shown
[NORMAL] Application started

Mẫu này phổ biến trong các công cụ sản xuất nơi độ chi tiết ghi nhật ký phải được điều chỉnh động mà không cần biên dịch lại.

Kết Hợp Tất Cả Các Mẫu

Bạn có thể kết hợp các ví dụ này thành một công cụ cấu hình duy nhất xử lý nhiều trách nhiệm. Ví dụ, một chương trình xử lý tệp chấp nhận các tùy chọn --mode, --log, và --input đồng thời.

java App --mode=prod --log=2 --input data.txt

Bằng cách cấu trúc phân tích đối số của bạn một cách cẩn thận, bạn có thể tạo ra các tiện ích dòng lệnh linh hoạt và có thể tái sử dụng phù hợp với môi trường triển khai thực tế.

Tóm Tắt Các Mẫu Thực Tế

  • ✅ Sử dụng các đối số để linh hoạt nhập/xuất tệp.
  • ✅ Cho phép chuyển đổi chế độ cho phát triển, kiểm thử và sản xuất.
  • ✅ Kích hoạt kiểm soát ghi log và gỡ lỗi từ dòng lệnh.
  • ✅ Kết hợp các tham số này để xây dựng công cụ tự động hoá đa năng.

Những ví dụ này đại diện cho nền tảng của các công cụ tự động hoá Java hiện đại — nhẹ, có tham số và dễ tích hợp với các script hoặc bộ lập lịch.

8. Các Thực Hành Tốt Nhất trong Triển Khai Thực Tế

Khi ứng dụng Java của bạn bắt đầu được sử dụng trong môi trường sản xuất, việc xử lý các đối số dòng lệnh một cách nhất quán và an toàn trở thành một phần của thiết kế phần mềm chuyên nghiệp. Phần này tóm tắt các thực hành tốt nhất trong thực tế để xử lý đối số một cách có thể bảo trì, an toàn và mở rộng.

1. Giữ Giao Diện Nhất Quán

Sau khi phát hành, ý nghĩa của mỗi đối số dòng lệnh nên được duy trì ổn định. Tránh đổi tên hoặc loại bỏ các tùy chọn hiện có trừ khi thực sự cần thiết. Khi thêm các tham số mới, hãy đảm bảo tính tương thích ngược bằng cách giữ nguyên hành vi mặc định.

// Old version
java ReportTool --mode=prod

// New version (compatible)
java ReportTool --mode=prod --log=2

Cách tiếp cận này tránh làm hỏng các script tự động, pipeline CI hoặc cron job phụ thuộc vào công cụ của bạn.

2. Cung Cấp Tùy Chọn Trợ Giúp

Mỗi công cụ dòng lệnh chuyên nghiệp nên cung cấp một flag --help hoặc -h dễ truy cập để giải thích cách sử dụng, các tùy chọn có sẵn và ví dụ.

if (args.length == 0 || Arrays.asList(args).contains("--help")) {
    System.out.println("Usage: java MyTool [options]");
    System.out.println("  --input <file>     Specify input file");
    System.out.println("  --mode <type>      Choose mode: dev, test, prod");
    System.out.println("  --log <level>      Set log verbosity (1-3)");
    System.exit(0);
}

Điều này không chỉ cải thiện tính khả dụng mà còn giảm lỗi người dùng và các yêu cầu hỗ trợ.

3. Tài Liệu Hành Vi Đối Số Rõ Ràng

Duy trì một README hoặc tài liệu trực tuyến cập nhật, liệt kê tất cả các đối số được hỗ trợ, giá trị mặc định và các ví dụ thực thi. Khi nhiều tùy chọn tương tác (ví dụ, --mode=prod vô hiệu hoá gỡ lỗi), hãy làm rõ các mối quan hệ đó một cách rõ ràng.

# Example documentation section

### Options
--mode=<value>     Select execution mode (dev/test/prod)
--log=<level>      Verbosity (1: normal, 2: verbose, 3: debug)
--input=<path>     Input file path

### Example
java MyTool --mode=prod --log=2 --input report.csv

4. Tách Cấu Hình Khỏi Mã Nguồn

Không nên mã cứng các tham số vận hành. Sử dụng các tệp cấu hình hoặc biến môi trường cho dữ liệu nhạy cảm hoặc giá trị mặc định, và cho phép các đối số dòng lệnh ghi đè chúng khi cần.

String defaultMode = System.getenv().getOrDefault("APP_MODE", "dev");
String mode = defaultMode;

// CLI arguments override environment variable
for (String arg : args) {
    if (arg.startsWith("--mode=")) {
        mode = arg.split("=", 2)[1];
    }
}
System.out.println("Running in " + mode + " mode");

Cấu trúc này cho phép cả nhà phát triển và người vận hành cấu hình hành vi mà không cần biên dịch lại hoặc sửa đổi mã.

5. Hỗ Trợ Cả Dạng Ngắn và Dạng Dài

Cung cấp cả dạng ngắn (-v) và dạng dài (--verbose) cải thiện sự tiện lợi cho các sở thích người dùng khác nhau:

if (arg.equals("-v") || arg.equals("--verbose")) {
    verbose = true;
}

Dạng kép này cũng giúp công cụ của bạn phù hợp với các quy ước UNIX/Linux, nâng cao tính khả dụng cho các kỹ sư có kinh nghiệm.

6. Trả Về Mã Thoát Có Ý Nghĩa

Các tích hợp như Jenkins, script shell hoặc hệ thống điều phối phụ thuộc vào mã thoát của tiến trình. Sử dụng các mã riêng biệt để báo hiệu thành công, cảnh báo và lỗi một cách rõ ràng. Ví dụ:

  • 0 — Thành công
  • 10 — Thiếu đối số bắt buộc
  • 20 — Lỗi xác thực
  • 30 — Ngoại lệ thời gian chạy

Điều này cho phép tự động hoá bên ngoài phản hồi một cách thông minh — ví dụ, chỉ thử lại khi gặp lỗi có thể khôi phục.

7. Ghi Log Đối Số và Môi Trường Một Cách An Toàn

Khi gỡ lỗi các vấn đề trong môi trường production, việc biết các đối số đã được truyền vào là rất quan trọng. Tuy nhiên, bạn nên ghi log chúng một cách cẩn thận:

  • Che giấu các giá trị nhạy cảm như mật khẩu hoặc token ( ****** ).
  • Chỉ ghi log các tham số an toàn, không mang tính cá nhân.
  • Bao gồm dấu thời gian và định danh tiến trình.

Ví dụ về log an toàn:

[2025-11-11 09:30:15] App started
Mode: prod
Log level: 2
Input: data.csv
Password: [REDACTED]

8. Sử dụng Thư viện để Mở rộng Quy mô

Đối với các công cụ quy mô lớn, tránh việc tự phân tích chuỗi thủ công và thay vào đó sử dụng các thư viện như:

  • Apache Commons CLI — đơn giản và đã được kiểm chứng.
  • Picocli — hiện đại, dựa trên annotation, và hỗ trợ xuất trợ giúp có màu.
  • JCommander — trực quan và nhẹ nhàng cho việc ràng buộc đối số.

Ví dụ (Picocli):

import picocli.CommandLine;
import picocli.CommandLine.Option;

public class App implements Runnable {
    @Option(names = {"-m", "--mode"}, description = "Execution mode")
    String mode = "dev";

    @Option(names = {"-l", "--log"}, description = "Log level")
    int log = 1;

    public void run() {
        System.out.println("Mode: " + mode + ", Log: " + log);
    }

    public static void main(String[] args) {
        new CommandLine(new App()).execute(args);
    }
}

Các thư viện như Picocli giảm đáng kể lượng mã mẫu, cung cấp kiểm tra tự động và tạo ra các thông báo trợ giúp một cách tự động.

9. Chuẩn bị cho Quốc tế hoá

Nếu ứng dụng của bạn hướng tới người dùng toàn cầu, hãy thiết kế các thông báo trợ giúp và log với khả năng địa phương hoá. Sử dụng các bundle tài nguyên (.properties files) cho các thông điệp thay vì mã cứng tiếng Anh.

ResourceBundle bundle = ResourceBundle.getBundle("messages", Locale.getDefault());
System.out.println(bundle.getString("usage.help"));

Điều này cho phép chương trình của bạn tự động chuyển đổi ngôn ngữ dựa trên locale của hệ thống.

10. Tự động Kiểm thử Logic Đối số

Đảm bảo việc phân tích đối số được bao phủ bởi các kiểm thử đơn vị để ngăn ngừa lỗi khi các tùy chọn được thêm hoặc sửa đổi.

@Test
void testModeArgument() {
    String[] args = {"--mode=prod"};
    assertDoesNotThrow(() -> MyApp.main(args));
}

Các kiểm thử tự động mang lại sự tự tin rằng CLI của bạn vẫn ổn định qua các bản cập nhật và tái cấu trúc.

Tổng kết

  • Duy trì cấu trúc đối số tương thích ngược.
  • Cung cấp tài liệu --help rõ ràng.
  • Tách cấu hình ra khỏi mã nguồn để tăng tính linh hoạt.
  • Sử dụng thư viện và tự động hoá để đạt độ tin cậy và khả năng bảo trì cao.
  • Xem xét quốc tế hoá và bảo mật ngay từ đầu.

Bằng cách áp dụng những hướng dẫn này, các công cụ dòng lệnh Java của bạn sẽ đạt được độ ổn định và khả năng sử dụng chuyên nghiệp trong cả môi trường nội địa và toàn cầu.

9. Tổng kết và Mẫu Thiết kế

Trong toàn bộ bài viết, chúng tôi đã khám phá vòng đời hoàn chỉnh của việc xử lý đối số dòng lệnh trong Java — từ cú pháp cơ bản đến các cân nhắc bảo mật và triển khai thực tế. Hãy cùng tóm tắt các khái niệm cốt lõi và cung cấp một mẫu thiết kế có thể tái sử dụng mà bạn có thể áp dụng cho dự án của mình.

Những Điểm Chính Cần Nhớ

  • ✅ Cấu trúc Cơ bản: Sử dụng String[] args trong phương thức main để nhận các tham số.
  • ✅ Kiểm tra: Luôn kiểm tra các đầu vào thiếu hoặc không hợp lệ và cung cấp phản hồi hữu ích.
  • ✅ Chuyển đổi: Chuyển đổi các đối số dạng chuỗi một cách an toàn sang kiểu số, boolean hoặc kiểu tùy chỉnh.
  • ✅ Phân tích Tùy chọn: Hỗ trợ cả tùy chọn ngắn ( -h ) và dài ( --help ) để tăng tính rõ ràng.
  • ✅ Bảo mật: Chuẩn hoá đường dẫn, làm sạch đầu vào và tránh thực thi lệnh không an toàn.
  • ✅ Ứng dụng Thực tế: Áp dụng đối số cho việc xử lý tệp, điều khiển chế độ và cấu hình log.
  • ✅ Thực hành Chuyên nghiệp: Cung cấp tài liệu, giao diện nhất quán và mã thoát.
  • ✅ Mở rộng: Sử dụng các thư viện như Picocli hoặc Commons CLI cho các dự án lớn hơn.
  • ✅ Tự động hoá: Kiểm thử việc xử lý đối số qua JUnit hoặc các pipeline CI.

Mẫu Thiết kế Có Thể Tái Sử Dụng

The following template integrates best practices discussed in this guide — validation, help display, environment mode handling, and logging levels — in one compact program.

import java.util.*;

public class AppTemplate {

    static class Config {
        String mode = "dev";
        int logLevel = 1;
        String input = null;
        boolean help = false;
    }

    public static void main(String[] args) {
        Config cfg = parseArgs(args);

        if (cfg.help) {
            printHelp();
            System.exit(0);
        }

        // Logging example
        if (cfg.logLevel >= 3) System.out.println("[DEBUG] Mode = " + cfg.mode);
        if (cfg.logLevel >= 2) System.out.println("[INFO] Log level set to " + cfg.logLevel);

        if (cfg.input != null) {
            System.out.println("[INFO] Processing input file: " + cfg.input);
        } else {
            System.out.println("[WARN] No input file specified. Running default mode.");
        }

        // Main logic
        System.out.println("Running in " + cfg.mode + " mode.");
    }

    private static Config parseArgs(String[] args) {
        Config cfg = new Config();
        for (String arg : args) {
            if (arg.equals("-h") || arg.equals("--help")) {
                cfg.help = true;
            } else if (arg.startsWith("--mode=")) {
                cfg.mode = arg.split("=", 2)[1];
            } else if (arg.startsWith("--log=")) {
                try {
                    cfg.logLevel = Integer.parseInt(arg.split("=", 2)[1]);
                } catch (NumberFormatException e) {
                    System.err.println("Invalid log level, using default (1).");
                }
            } else if (arg.startsWith("--input=")) {
                cfg.input = arg.split("=", 2)[1];
            }
        }
        return cfg;
    }

    private static void printHelp() {
        System.out.println("Usage: java AppTemplate [options]");
        System.out.println("Options:");
        System.out.println("  --mode=<dev|test|prod>    Execution mode (default: dev)");
        System.out.println("  --log=<1|2|3>              Log level (1:normal, 2:verbose, 3:debug)");
        System.out.println("  --input=<file>             Input file path");
        System.out.println("  -h, --help                 Show this help message");
    }
}

This design provides:

  • Phân tích đối số rõ ràng, tách biệt khỏi logic nghiệp vụ.
  • Tự động hiển thị trợ giúp.
  • Chuyển đổi số an toàn và giá trị mặc định.
  • Kiểm soát logging đơn giản cho chế độ gỡ lỗi và sản xuất.

Mở rộng mẫu

Bạn có thể mở rộng mẫu cơ bản này theo nhiều hướng:

  • Thêm kiểm tra tồn tại tệp và xử lý ngoại lệ.
  • Tích hợp với Properties hoặc tệp cấu hình JSON.
  • Hỗ trợ các subcommand (ví dụ: java Tool analyze, java Tool export).
  • Triển khai đầu ra console có màu hoặc logging có cấu trúc.
  • Tải biến môi trường làm giá trị mặc định cho các đối số còn thiếu.

Bằng cách kết hợp những cải tiến này, bạn có thể phát triển cấu trúc nhẹ này thành một khung CLI mạnh mẽ, phù hợp với nhu cầu dự án của bạn.

Lời kết

Các đối số dòng lệnh có thể trông đơn giản, nhưng chúng là nền tảng của phần mềm có thể cấu hình, kiểm thử và tự động hoá. Thiết kế chúng với cùng mức độ cẩn thận như bạn thiết kế giao diện API — sạch sẽ, dự đoán được và an toàn.

Tóm lại: Đầu tư công sức vào thiết kế đối số có cấu trúc tốt sẽ mang lại lợi ích ở mọi giai đoạn phát triển — từ gỡ lỗi và tự động hoá đến triển khai và bảo trì lâu dài.

Với những nguyên tắc và mẫu này, bạn có thể thiết kế các công cụ dòng lệnh chuyên nghiệp, hoạt động nhất quán trên mọi môi trường, đội ngũ và năm tháng phát triển.

FAQ — Các câu hỏi thường gặp

Phần này tóm tắt các câu hỏi phổ biến mà các nhà phát triển gặp phải khi xử lý đối số dòng lệnh trong Java. Mỗi câu trả lời bao gồm các ví dụ ngắn hoặc hướng dẫn thực tế.

Q1. Làm thế nào để tôi xử lý cả đối số tùy chọn và bắt buộc?

Các đối số bắt buộc nên được xác thực một cách rõ ràng — ví dụ, bằng cách kiểm tra args.length hoặc sự hiện diện của một cờ cụ thể. Các đối số tùy chọn có thể có giá trị mặc định an toàn.

if (args.length < 1) {
    System.err.println("Error: Missing input file");
    System.exit(1);
}

String input = args[0];
String mode = (args.length > 1) ? args[1] : "dev";

Trong các dự án lớn hơn, hãy định nghĩa schema đối số của bạn bằng các thư viện như Picocli hoặc Apache Commons CLI, chúng hỗ trợ tự động các cờ bắt buộc/tùy chọn.

Q2. Làm sao để bao gồm khoảng trắng trong một đối số (như tên tệp hoặc cụm từ)?

Bao quanh đối số bằng dấu ngoặc kép khi chạy từ terminal:

java Example "New York City" Japan

Kết quả:

args[0] = New York City
args[1] = Japan

Điều này đảm bảo toàn bộ cụm từ được coi là một đối số duy nhất, không phải nhiều từ.

Q3. Điều gì sẽ xảy ra nếu không có đối số nào được cung cấp?

Nếu không có đối số nào được truyền, args.length sẽ bằng 0. Bạn có thể an toàn phát hiện và xử lý bằng cách hiển thị thông báo trợ giúp hoặc sử dụng các giá trị mặc định.

if (args.length == 0) {
    System.out.println("No arguments provided. Running default mode...");
}

Q4. Làm sao để kiểm tra các đối số trong IDE như IntelliJ hoặc Eclipse?

Cả hai IDE đều có hộp thoại cấu hình cho các đối số chương trình:

  • Eclipse: Run → Run Configurations → tab Arguments → nhập đối số.
  • IntelliJ IDEA: Run → Edit Configurations → trường Program arguments.

Ví dụ: --mode=prod --log=2 --input=data.txt

Q5. Làm sao để xử lý các cờ boolean như “–debug” hoặc “–verbose”?

Các cờ boolean thường xuất hiện mà không có giá trị. Bạn có thể phát hiện chúng bằng các phương thức equals() hoặc contains().

boolean debug = false;
for (String arg : args) {
    if (arg.equals("--debug") || arg.equals("-d")) {
        debug = true;
    }
}

if (debug) System.out.println("Debug mode enabled.");

Q6. Làm sao để truyền nhiều đối số cho các ứng dụng “java -jar”?

Khi chạy một tệp JAR đã đóng gói, đặt các đối số sau tên JAR. Ví dụ:

java -jar MyApp.jar --mode=prod input.txt --log=3

Phương thức main(String[] args) của ứng dụng sẽ nhận các đối số giống như trong một lần thực thi tiêu chuẩn.

Q7. Làm sao để đọc các đối số từ tệp cấu hình thay vì dòng lệnh?

Bạn có thể sử dụng Properties của Java hoặc các thư viện YAML/JSON để tải các cài đặt mặc định, sau đó ghi đè chúng bằng các đối số CLI nếu được chỉ định.

Properties props = new Properties();
props.load(new FileInputStream("config.properties"));
String mode = props.getProperty("mode", "dev");

// CLI overrides file
for (String arg : args) {
    if (arg.startsWith("--mode=")) {
        mode = arg.split("=", 2)[1];
    }
}

Q8. Tôi có thể sử dụng ký tự Unicode hoặc không phải ASCII trong các đối số không?

Có, Java hoàn toàn hỗ trợ chuỗi Unicode trong args. Tuy nhiên, terminal hoặc bộ mã của hệ điều hành cũng phải hỗ trợ các ký tự bạn sử dụng. Trên Windows, cân nhắc chạy với locale UTF-8 (chcp 65001), và trên Linux/macOS, đảm bảo shell sử dụng mã hoá UTF-8.

Q9. Làm sao để ngăn ngừa các vấn đề bảo mật với các đối số do người dùng cung cấp?

  • ✅ Xác thực tất cả đầu vào (phạm vi số, đường dẫn tệp, URL).
  • ✅ Chuẩn hoá đường dẫn để ngăn traversal thư mục (../).
  • ✅ Không bao giờ nối đầu vào người dùng vào lệnh shell.
  • ✅ Sử dụng whitelist hoặc mẫu regex để xác thực chặt chẽ.

Đối với các công cụ sản xuất, cân nhắc từ chối hoặc escape các ký tự như ;, |, hoặc && có thể kích hoạt thực thi shell.

Q10. Tôi có nên vẫn sử dụng “args” một cách thủ công hay nên áp dụng một thư viện?

Đối với các tiện ích nhỏ, việc phân tích thủ công với String[] args là ổn. Đối với các công cụ lâu dài hoặc cấp doanh nghiệp, hãy sử dụng một thư viện chuyên dụng:

  • Picocli — dựa trên annotation, dễ tích hợp.
  • Apache Commons CLI — thư viện cổ điển đã được kiểm chứng.
  • JCommander — đơn giản và nhẹ.

Sử dụng một thư viện giúp giảm lỗi, cải thiện khả năng đọc, và cung cấp các tính năng trợ giúp và xác thực tích hợp.

Câu hỏi 11. Làm thế nào để tôi có thể in tất cả các đối số nhận được một cách dễ dàng?

System.out.println("Received arguments:");
for (int i = 0; i < args.length; i++) {
    System.out.printf("args[%d] = %s%n", i, args[i]);
}

Đoạn mã này hoàn hảo để gỡ lỗi logic phân tích đối số.

Câu hỏi 12. Tôi có thể kết hợp đối số và biến môi trường không?

Có. Biến môi trường rất hữu ích cho cấu hình toàn hệ thống (như khóa API), trong khi đối số dòng lệnh thích hợp cho việc ghi đè tạm thời.

String apiKey = System.getenv().getOrDefault("API_KEY", "none");
for (String arg : args) {
    if (arg.startsWith("--api=")) {
        apiKey = arg.split("=", 2)[1];
    }
}
System.out.println("API Key: " + (apiKey.equals("none") ? "not set" : "[REDACTED]"));

Mô hình cấu hình lớp này giữ cho phần mềm của bạn vừa linh hoạt vừa an toàn.

Câu hỏi 13. Làm sao để xử lý các loại đối số không đúng một cách nhẹ nhàng?

Sử dụng các khối try-catch và cung cấp thông báo lỗi có ý nghĩa mà không làm chương trình bị sập:

try {
    int threads = Integer.parseInt(args[0]);
} catch (NumberFormatException e) {
    System.err.println("Invalid number format: " + args[0]);
    System.exit(1);
}

Điều này đảm bảo việc kết thúc sạch sẽ và giúp người dùng sửa lỗi nhập liệu nhanh chóng.

Câu hỏi 14. Tôi có thể hiển thị đầu ra màu cho trợ giúp hoặc lỗi không?

Có, bạn có thể sử dụng mã escape ANSI để hiển thị màu trong hầu hết các terminal:

final String RED = "u001B[31m";
final String RESET = "u001B[0m";
System.err.println(RED + "Error: Invalid argument" + RESET);

Các thư viện như Picocli và Jansi có thể tự động xử lý việc này với khả năng tương thích đa nền tảng.

Câu hỏi 15. Làm sao để tôi gỡ lỗi việc phân tích đối số hiệu quả hơn?

Thêm chế độ “chẩn đoán” với các cờ --debug hoặc --trace để in ra toàn bộ trạng thái nội bộ khi khởi động. Ví dụ:

if (Arrays.asList(args).contains("--debug")) {
    System.out.println("[TRACE] Arguments: " + Arrays.toString(args));
}

Điều này cực kỳ hữu ích khi khắc phục sự cố tự động hoá hoặc các vấn đề cấu hình trong môi trường sản xuất.