Command Line এর Error Handling এবং Debugging

Apache Commons CLI লাইব্রেরি কমান্ড-লাইন আর্গুমেন্ট প্রোসেসিংয়ের জন্য ব্যবহৃত হয় এবং এর মাধ্যমে ব্যবহারকারীর ইনপুট সহজভাবে প্রক্রিয়া করা যায়। তবে, যেহেতু কমান্ড লাইন আর্গুমেন্টগুলি সাধারণত ব্যবহারকারীদের কাছ থেকে আসতে থাকে, তাই এর সাথে সম্পর্কিত ত্রুটি হ্যান্ডলিং এবং ডিবাগিং গুরুত্বপূর্ণ। এ ক্ষেত্রে, Command Line Parsing ত্রুটির জন্য যথাযথ ত্রুটি বার্তা এবং ডিবাগিং কৌশল ব্যবহার করা উচিত যাতে ব্যবহারকারীরা সহজে সমস্যাটি বুঝতে পারে এবং সমাধান করতে পারে।

এখানে আমরা দেখব কীভাবে Apache Commons CLI ব্যবহার করে কমান্ড-লাইন আর্গুমেন্টের ত্রুটি সঠিকভাবে হ্যান্ডল করা যায় এবং কীভাবে ডিবাগিং করা যায়।

1. Error Handling in Apache Commons CLI

কমান্ড লাইন আর্গুমেন্টের সাথে কাজ করার সময় বেশ কিছু সাধারণ ত্রুটি ঘটতে পারে, যেমন:

• অপর্যাপ্ত বা ভুল আর্গুমেন্ট প্রদান
• অপর্যাপ্ত আর্গুমেন্টের জন্য ত্রুটি বার্তা
• অপর্যাপ্ত অপশনগুলির জন্য ত্রুটি

Apache Commons CLI ত্রুটি হ্যান্ডলিংয়ের জন্য ParseException ব্যবহার করে। এই ধরনের ত্রুটিগুলি প্রক্রিয়া করার জন্য আপনি সঠিক ত্রুটি বার্তা এবং সহায়ক বার্তা প্রদর্শন করতে পারেন।

উদাহরণ: ত্রুটি হ্যান্ডলিং

import org.apache.commons.cli.*;

public class CommandLineErrorHandling {

    public static void main(String[] args) {

        // Command Line Options তৈরি করা
        Options options = new Options();

        // "username" অপশন যোগ করা
        Option usernameOption = new Option("u", "username", true, "Username for login");
        usernameOption.setRequired(true);  // এই অপশনটি অবশ্যই প্রদান করতে হবে
        options.addOption(usernameOption);

        // "password" অপশন যোগ করা
        Option passwordOption = new Option("p", "password", true, "Password for login");
        passwordOption.setRequired(true);  // এই অপশনটি অবশ্যই প্রদান করতে হবে
        options.addOption(passwordOption);

        // CommandLineParser তৈরি করা
        CommandLineParser parser = new DefaultParser();
        HelpFormatter formatter = new HelpFormatter();

        try {
            // আর্গুমেন্ট পার্স করা
            CommandLine cmd = parser.parse(options, args);

            // "username" এবং "password" আর্গুমেন্ট রিড করা
            String username = cmd.getOptionValue("username");
            String password = cmd.getOptionValue("password");

            // আউটপুট
            System.out.println("Username: " + username);
            System.out.println("Password: " + password);

        } catch (ParseException e) {
            // ত্রুটি বার্তা দেখানো
            System.out.println("Error: " + e.getMessage());
            formatter.printHelp("CommandLineErrorHandling", options);
        }
    }
}

ব্যাখ্যা:

1. Options তৈরি করা: এখানে দুটি অপশন যোগ করা হয়েছে—username এবং password।
2. CommandLineParser: DefaultParser ব্যবহার করা হয়েছে আর্গুমেন্ট পার্স করার জন্য।
3. Error Handling: ParseException ব্যবহার করে যেকোনো ত্রুটি ধরা হয় এবং তার সঠিক বার্তা প্রদর্শন করা হয়।
4. HelpFormatter: ত্রুটি হলে সহায়ক বার্তা প্রদর্শন করা হয় যাতে ব্যবহারকারী জানে কীভাবে সঠিকভাবে অপশনগুলো প্রদান করতে হবে।

ত্রুটি উদাহরণ:

java CommandLineErrorHandling

এটি চলানোর পর ত্রুটি বার্তা দেখা যাবে:

Error: Missing required option: u
usage: CommandLineErrorHandling
 -u,--username <arg>   Username for login
 -p,--password <arg>   Password for login

2. Command Line Debugging

কমান্ড-লাইন আর্গুমেন্ট প্রোসেসিংয়ের সময় ডিবাগিং করা খুবই গুরুত্বপূর্ণ, বিশেষ করে যখন আর্গুমেন্টগুলো খুব জটিল বা ডাইনামিক হয়। Apache Commons CLI আপনাকে CommandLine অবজেক্টের মাধ্যমে আর্গুমেন্টগুলি ডিবাগ করার সুবিধা প্রদান করে, যা আপনাকে আর্গুমেন্টগুলি সঠিকভাবে পাচ্ছেন কিনা তা যাচাই করতে সাহায্য করবে।

উদাহরণ: ডিবাগিং করা

import org.apache.commons.cli.*;

public class CommandLineDebugging {

    public static void main(String[] args) {

        // Command Line Options তৈরি করা
        Options options = new Options();

        // "username" অপশন যোগ করা
        Option usernameOption = new Option("u", "username", true, "Username for login");
        options.addOption(usernameOption);

        // "password" অপশন যোগ করা
        Option passwordOption = new Option("p", "password", true, "Password for login");
        options.addOption(passwordOption);

        // CommandLineParser তৈরি করা
        CommandLineParser parser = new DefaultParser();
        HelpFormatter formatter = new HelpFormatter();

        try {
            // আর্গুমেন্ট পার্স করা
            CommandLine cmd = parser.parse(options, args);

            // আর্গুমেন্টগুলি ডিবাগ করার জন্য প্রিন্ট করা
            System.out.println("Command Line Arguments:");
            String[] parsedArgs = cmd.getArgs();
            for (String arg : parsedArgs) {
                System.out.println(arg);
            }

            // "username" এবং "password" আর্গুমেন্ট রিড করা
            String username = cmd.getOptionValue("username");
            String password = cmd.getOptionValue("password");

            // আউটপুট
            System.out.println("Username: " + username);
            System.out.println("Password: " + password);

        } catch (ParseException e) {
            // ত্রুটি বার্তা দেখানো
            System.out.println("Error: " + e.getMessage());
            formatter.printHelp("CommandLineDebugging", options);
        }
    }
}

ব্যাখ্যা:

1. CommandLine Parsing: আর্গুমেন্টগুলি পার্স করার পর, cmd.getArgs() ব্যবহার করে আপনি সমস্ত আর্গুমেন্ট দেখতে পারেন। এটি ডিবাগিংয়ে সাহায্য করে যাতে আপনি নিশ্চিত হতে পারেন যে আর্গুমেন্টগুলি সঠিকভাবে এসেছে কিনা।
2. Debugging Output: আর্গুমেন্টগুলির সমস্ত মান প্রিন্ট করা হচ্ছে, যা আপনাকে ডিবাগ করার সময় আর্গুমেন্টগুলির মান যাচাই করতে সাহায্য করবে।

আউটপুট (Debugging):

যদি আপনি নিম্নলিখিত কমান্ড রান করেন:

java CommandLineDebugging -u john_doe -p secretpassword

আউটপুট হবে:

Command Line Arguments:
-u
john_doe
-p
secretpassword
Username: john_doe
Password: secretpassword

এটি আর্গুমেন্টগুলি কীভাবে পার্স হচ্ছে তা ডিবাগ করতে সাহায্য করবে।

3. কাস্টম Error Handling এবং Debugging কৌশল

• কাস্টম ত্রুটি বার্তা: আপনি ParseException এর মাধ্যমে কাস্টম ত্রুটি বার্তা তৈরি করতে পারেন, যেমন ব্যবহারকারীদের জানানো যে তারা কোন অপশন ভুলভাবে দিয়েছেন বা মিস করেছেন।
• ডিবাগging ফ্ল্যাগ: verbose বা debug ফ্ল্যাগ ব্যবহার করে আপনি ডিবাগিংয়ের সময় অতিরিক্ত তথ্য দেখাতে পারেন।

উদাহরণ: ডিবাগ ফ্ল্যাগ যোগ করা

Option debugOption = new Option("d", "debug", false, "Enable debug output");
options.addOption(debugOption);

// Debugging flag check
if (cmd.hasOption("debug")) {
    System.out.println("Debugging enabled");
}

এটি ডিবাগ ফ্ল্যাগ ব্যবহারের মাধ্যমে আর্গুমেন্টের ডিবাগ আউটপুট সরবরাহ করবে।

Apache Commons CLI লাইব্রেরি ত্রুটি হ্যান্ডলিং এবং ডিবাগিংয়ের জন্য শক্তিশালী সমাধান সরবরাহ করে। ParseException ব্যবহার করে ত্রুটি সঠিকভাবে হ্যান্ডল করা যায় এবং HelpFormatter এর মাধ্যমে ব্যবহারকারীদের সাহায্য বার্তা প্রদর্শন করা যায়। ডিবাগিংয়ের জন্য CommandLine অবজেক্টে আর্গুমেন্টগুলি পরীক্ষা করে দেখতে পারেন, যা আপনাকে সমস্যা চিহ্নিত করতে সহায়তা করবে। CLI টুলগুলির জন্য সঠিক ত্রুটি হ্যান্ডলিং এবং ডিবাগging কৌশল ব্যবহার করলে আপনার অ্যাপ্লিকেশন আরও শক্তিশালী এবং ব্যবহারকারী-বান্ধব হবে।

কমান্ড লাইন আর্গুমেন্ট প্রসেসিংয়ে সাধারণ ত্রুটি

কমান্ড লাইন আর্গুমেন্ট পার্সিংয়ের সময় বেশ কিছু সাধারণ ত্রুটি হতে পারে। Apache Commons CLI লাইব্রেরি ব্যবহার করার সময় এই ত্রুটিগুলি সনাক্ত করা এবং সঠিকভাবে মোকাবেলা করা অত্যন্ত গুরুত্বপূর্ণ। নিচে কিছু সাধারণ ত্রুটি এবং তাদের সমাধান আলোচনা করা হলো।

1. ParseException: Unrecognized option ত্রুটি

এই ত্রুটিটি ঘটে যখন ব্যবহারকারী কমান্ড লাইনে এমন একটি অপশন প্রদান করেন যা প্রোগ্রামের কাছে পরিচিত নয়। সাধারণত, এটি অপশনগুলির ভুল নাম বা মিসপেলিংয়ের কারণে ঘটে।

সমাধান:

1. অপশন চেক করা: নিশ্চিত করুন যে আপনি কমান্ড লাইন ইনপুটে সঠিক অপশন লিখছেন।
2. অপশন হ্যান্ডলিং: আপনি যদি -h বা --help অপশন ব্যবহার করেন, তবে ব্যবহারকারীদের সাহায্যের জন্য একটি হেল্প মেসেজ দেখানোর ব্যবস্থা করুন।

উদাহরণ:

java MyApp -x

এই ক্ষেত্রে -x অপশনটি যদি প্রোগ্রামে নির্ধারিত না থাকে, তাহলে নিম্নলিখিত ত্রুটি হবে:

Exception in thread "main" org.apache.commons.cli.ParseException: Unrecognized option: -x

সমাধান:

Options অবজেক্টে অপশনগুলির সঠিক সংজ্ঞা নিশ্চিত করুন:

options.addOption("f", "file", true, "File path");
options.addOption("v", "verbose", false, "Verbose output");

এটি শুধুমাত্র -f এবং -v অপশনগুলিকে অনুমোদন করবে।

2. Missing argument for option ত্রুটি

যখন একটি অপশনের জন্য মান (argument) প্রদান করা হয় না, তখন এই ত্রুটিটি ঘটে। উদাহরণস্বরূপ, যদি আপনি -f অপশন ব্যবহার করেন কিন্তু তার মান না দেন, তাহলে এই ত্রুটি দেখাবে।

উদাহরণ:

java MyApp -f

এই ক্ষেত্রে -f অপশনের জন্য ফাইল পাথ প্রদান করা হয়নি, তাই ত্রুটি হবে:

Exception in thread "main" org.apache.commons.cli.ParseException: Missing argument for option: f

সমাধান:

1. অপশনগুলির জন্য মান প্রদান: নিশ্চিত করুন যে, যেখানে অপশনগুলির জন্য মান দেওয়া প্রয়োজন সেখানে মান পাঠানো হয়েছে।
2. মানের জন্য প্রম্পট: আপনি যদি আর্গুমেন্ট না পান, তবে সঠিক ত্রুটি বার্তা দিয়ে ব্যবহারকারীকে জানাতে পারেন।

if (cmd.hasOption("f")) {
    String filePath = cmd.getOptionValue("f");
    if (filePath == null || filePath.isEmpty()) {
        throw new ParseException("File path must be provided with the -f option");
    }
}

3. Unexpected argument ত্রুটি

এই ত্রুটি তখন হয় যখন একটি অপশন ব্যবহার করার পরে অতিরিক্ত বা অবাঞ্ছিত আর্গুমেন্ট প্রদর্শিত হয়। এটি সাধারণত আর্গুমেন্টের ভুল ব্যবস্থাপনা বা ভুলভাবে আর্গুমেন্টের স্থানের কারণে ঘটে।

উদাহরণ:

java MyApp -f input.txt extraArgument

এখানে, extraArgument একটি অবাঞ্ছিত আর্গুমেন্ট এবং এটি CLI পার্সারের কাছে অপ্রত্যাশিত বলে ধরা পড়বে।

Exception in thread "main" org.apache.commons.cli.ParseException: Unexpected argument: extraArgument

সমাধান:

1. অপশন পার্সিং সম্পাদন করা: আপনি যদি আর্গুমেন্টে অতিরিক্ত ইনপুট চান না, তবে args পার্সিং শুরুর আগে সেই ইনপুটগুলো হ্যান্ডেল করুন।
2. Help মেসেজ দিয়ে গাইড করা: ইনপুটের ভুল ব্যবহারের ক্ষেত্রে, একটি হেল্প বার্তা প্রদর্শন করুন যাতে ব্যবহারকারী সঠিকভাবে অপশনগুলো ব্যবহার করতে পারেন।

if (cmd.getArgList().size() > 0) {
    System.out.println("Unexpected arguments: " + cmd.getArgList());
    formatter.printHelp("MyApp", options);
}

4. Option [option] requires a value ত্রুটি

যখন আপনি এমন একটি অপশন ব্যবহার করেন যার মান দেওয়া প্রয়োজন, কিন্তু মানটি না দেওয়া হয়, তখন এই ত্রুটিটি ঘটে। সাধারণত এটি -f বা -d মত অপশনের ক্ষেত্রে দেখা যায়।

উদাহরণ:

java MyApp -f

এখানে -f অপশনটির জন্য একটি মান (যেমন ফাইল পাথ) প্রয়োজন, কিন্তু কিছু না দিয়ে কেবল -f প্রদান করা হয়েছে। ফলস্বরূপ, ত্রুটি হবে:

Exception in thread "main" org.apache.commons.cli.MissingArgumentException: Option 'f' requires a value

সমাধান:

1. অপশনগুলি নিশ্চিত করা: অপশনগুলির মান সঠিকভাবে দেওয়া হচ্ছে কিনা নিশ্চিত করুন। ব্যবহারকারী যদি মান না দেয়, তবে প্রাসঙ্গিক ত্রুটি বার্তা প্রদান করুন।
2. অপশনগুলির জন্য ডিফল্ট মান প্রদান করা: আপনি যদি কিছু অপশনের জন্য ডিফল্ট মান নির্ধারণ করেন, তবে ত্রুটির সম্ভাবনা কমে যাবে।

options.addOption(Option.builder("f")
                        .hasArg(true)
                        .desc("File to process")
                        .build());

5. HelpFormatter ব্যবহার করে সহায়তা প্রদর্শন

যখন কোনো ত্রুটি ঘটে, বা ব্যবহারকারী -h বা --help অপশন চায়, তখন আপনি HelpFormatter ব্যবহার করে সাহায্য বার্তা প্রদর্শন করতে পারেন। এটি ব্যবহারকারীকে সঠিকভাবে কমান্ড এবং অপশন ব্যবহারের উপায় জানাতে সহায়তা করে।

HelpFormatter formatter = new HelpFormatter();
formatter.printHelp("MyApp", options);

এটি ব্যবহারকারীকে সমস্ত অপশন এবং তাদের বর্ণনা প্রদর্শন করবে, যাতে তারা সঠিকভাবে আর্গুমেন্ট প্রদান করতে পারে।

সারাংশ

Apache Commons CLI লাইব্রেরি ব্যবহার করার সময় সাধারণ ত্রুটিগুলি, যেমন "Unrecognized option", "Missing argument", "Unexpected argument", ইত্যাদি সাধারণভাবে ঘটে। তবে, এই ত্রুটিগুলি মোকাবেলা করার জন্য আপনি ত্রুটি বার্তা এবং হেল্প ফাংশন ব্যবহার করে সঠিকভাবে তাদের সমাধান করতে পারেন। আর্গুমেন্ট ও অপশন হ্যান্ডলিংকে সাবলীল করতে HelpFormatter এবং ParseException ব্যবহৃত হলে আপনি আরো কার্যকরী CLI অ্যাপ্লিকেশন তৈরি করতে পারবেন।

Apache Commons CLI লাইব্রেরি কমান্ড লাইন আর্গুমেন্ট পার্সিংকে সহজ করে, কিন্তু কখনো কখনো ভুল অপশন বা অনুপস্থিত আর্গুমেন্টের কারণে পার্সিংয়ের সমস্যা হতে পারে। এই ধরনের সমস্যাগুলো সঠিকভাবে হ্যান্ডল করা প্রয়োজন, যাতে ব্যবহারকারীর জন্য সাহায্য প্রদর্শন করা যায় এবং অ্যাপ্লিকেশন সঠিকভাবে চলতে থাকে।

এই গাইডে, আমরা দেখব Invalid Option, Missing Argument, এবং অন্যান্য সাধারণ কমান্ড লাইন আর্গুমেন্ট সম্পর্কিত ত্রুটিগুলো কিভাবে হ্যান্ডল করা যায়।

Invalid Option Handling

যখন ব্যবহারকারী কোনো ভুল অপশন প্রদান করেন, তখন ParseException অথবা HelpFormatter ব্যবহার করে তাকে ভুল অপশন সম্পর্কে জানানো যেতে পারে।

উদাহরণ: Invalid Option হ্যান্ডলিং

import org.apache.commons.cli.*;

public class InvalidOptionExample {

    public static void main(String[] args) {
        Options options = new Options();

        // 'input' অপশন তৈরি করা
        Option input = new Option("i", "input", true, "Input file");
        input.setRequired(true);  // এটি Required অপশন
        options.addOption(input);

        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = null;

        try {
            // আর্গুমেন্ট পার্স করা
            cmd = parser.parse(options, args);

            // 'input' অপশন থেকে ফাইল নাম বের করা
            System.out.println("Input file: " + cmd.getOptionValue("input"));

        } catch (ParseException e) {
            // ভুল অপশন দেয়ার ক্ষেত্রে Help প্রদর্শন করা
            System.out.println("Invalid option or missing argument.");
            HelpFormatter formatter = new HelpFormatter();
            formatter.printHelp("InvalidOptionExample", options);
        }
    }
}

ব্যাখ্যা:

• এখানে input অপশনটি required করা হয়েছে, অর্থাৎ এটি কমান্ড লাইনে অবশ্যই দিতে হবে।
• যদি ব্যবহারকারী কোনো ভুল অপশন দেয় বা -i অপশনটি না দেয়, তাহলে ParseException থ্রো হবে এবং HelpFormatter এর মাধ্যমে সাহায্য দেখানো হবে।

উদাহরণ চালানো:

java InvalidOptionExample -x somefile.txt

আউটপুট:

Invalid option or missing argument.
Usage: InvalidOptionExample
 -i,--input <arg>   Input file

Missing Argument Handling

অনেক সময় একটি অপশনের জন্য আর্গুমেন্ট দেওয়া হয় না, যা Missing Argument এর কারণে সমস্যা সৃষ্টি করে। এই ধরনের পরিস্থিতি সঠিকভাবে হ্যান্ডল করা প্রয়োজন।

উদাহরণ: Missing Argument হ্যান্ডলিং

import org.apache.commons.cli.*;

public class MissingArgumentExample {

    public static void main(String[] args) {
        Options options = new Options();

        // 'output' অপশন তৈরি করা
        Option output = new Option("o", "output", true, "Output file");
        output.setRequired(true);  // এটি Required অপশন
        options.addOption(output);

        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = null;

        try {
            // আর্গুমেন্ট পার্স করা
            cmd = parser.parse(options, args);

            // 'output' অপশন থেকে আর্গুমেন্ট বের করা
            String outputFile = cmd.getOptionValue("output");
            System.out.println("Output file: " + outputFile);

        } catch (ParseException e) {
            // Missing argument দেয়ার ক্ষেত্রে Help প্রদর্শন করা
            System.out.println("Missing argument for option: " + e.getMessage());
            HelpFormatter formatter = new HelpFormatter();
            formatter.printHelp("MissingArgumentExample", options);
        }
    }
}

ব্যাখ্যা:

• এখানে output অপশনটি required করা হয়েছে, এবং এটি অবশ্যই একটি আর্গুমেন্ট গ্রহণ করবে।
• যদি আর্গুমেন্ট না দেয়া হয়, তাহলে ParseException ক্যাচ করা হবে এবং HelpFormatter ব্যবহার করে ব্যবহারকারীকে সাহায্য প্রদর্শন করা হবে।

উদাহরণ চালানো:

java MissingArgumentExample -o

আউটপুট:

Missing argument for option: output
Usage: MissingArgumentExample
 -o,--output <arg>   Output file

Unknown Option Handling

কখনও কখনও ব্যবহারকারী অজানা বা অগ্রহণযোগ্য অপশন দেয়, যেমন -x। এই ধরনের অপশনগুলিকে সঠিকভাবে হ্যান্ডল করতে হবে।

উদাহরণ: Unknown Option Handling

import org.apache.commons.cli.*;

public class UnknownOptionExample {

    public static void main(String[] args) {
        Options options = new Options();

        // 'input' অপশন তৈরি করা
        Option input = new Option("i", "input", true, "Input file");
        input.setRequired(true);  // এটি Required অপশন
        options.addOption(input);

        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = null;

        try {
            // আর্গুমেন্ট পার্স করা
            cmd = parser.parse(options, args);

            // 'input' অপশন থেকে আর্গুমেন্ট বের করা
            System.out.println("Input file: " + cmd.getOptionValue("input"));

        } catch (ParseException e) {
            // অজানা অপশন দেয়ার ক্ষেত্রে Help প্রদর্শন করা
            System.out.println("Unknown option: " + e.getMessage());
            HelpFormatter formatter = new HelpFormatter();
            formatter.printHelp("UnknownOptionExample", options);
        }
    }
}

ব্যাখ্যা:

• এখানে যদি ব্যবহারকারী অজানা অপশন দেয়, তাহলে ParseException থ্রো হবে এবং HelpFormatter ব্যবহার করে Unknown option মেসেজ দেখানো হবে।

উদাহরণ চালানো:

java UnknownOptionExample -x

আউটপুট:

Unknown option: -x
Usage: UnknownOptionExample
 -i,--input <arg>   Input file

Combining Invalid and Missing Argument Handling

একটি অ্যাপ্লিকেশনে আপনি Invalid Option, Missing Argument, এবং Unknown Option সকল পরিস্থিতি একত্রে হ্যান্ডল করতে পারেন, এবং এতে সঠিকভাবে সাহায্য প্রদান করতে পারেন।

import org.apache.commons.cli.*;

public class CombinedHandlingExample {

    public static void main(String[] args) {
        Options options = new Options();

        // 'username' অপশন তৈরি করা
        Option username = new Option("u", "username", true, "Username");
        username.setRequired(true);  // Required
        options.addOption(username);

        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = null;

        try {
            // আর্গুমেন্ট পার্স করা
            cmd = parser.parse(options, args);

            // 'username' অপশন থেকে মান বের করা
            String usernameValue = cmd.getOptionValue("username");
            System.out.println("Username: " + usernameValue);

        } catch (ParseException e) {
            // Error হ্যান্ডলিং
            System.out.println("Error: " + e.getMessage());
            HelpFormatter formatter = new HelpFormatter();
            formatter.printHelp("CombinedHandlingExample", options);
        }
    }
}

উদাহরণ চালানো:

java CombinedHandlingExample -u

আউটপুট:

Error: Missing argument for option: username
Usage: CombinedHandlingExample
 -u,--username <arg>   Username

সারাংশ

Apache Commons CLI লাইব্রেরি দিয়ে আপনি সহজে Invalid Option, Missing Argument, Unknown Option ইত্যাদি ত্রুটিগুলি হ্যান্ডল করতে পারেন। এটি ব্যবহারকারীদের সঠিকভাবে কমান্ড লাইন আর্গুমেন্ট প্রদান করতে সহায়তা করে এবং তাদের জন্য HelpFormatter ব্যবহার করে সাহায্য প্রদর্শন করে। এর মাধ্যমে আপনি ব্যবহারকারীর ইন্টারঅ্যাকশনকে আরো কার্যকর এবং ইউজার-ফ্রেন্ডলি করতে পারেন।

Apache Commons CLI লাইব্রেরি কমান্ড লাইন আর্গুমেন্ট পার্স করার জন্য একটি শক্তিশালী টুল, যা ব্যবহারকারীর ইনপুট সঠিকভাবে যাচাই এবং হ্যান্ডল করার জন্য বিভিন্ন ফিচার সরবরাহ করে। তবে, কমান্ড লাইন আর্গুমেন্টে যদি কোনো ভুল থাকে বা ব্যবহারকারীরা ভুলভাবে আর্গুমেন্ট প্রদান করে, তবে আপনি Custom Error Messages এবং Exception Handling ব্যবহার করে একটি আরও উন্নত এবং ব্যবহারকারী-বান্ধব অভিজ্ঞতা তৈরি করতে পারেন।

এখানে, আমরা দেখবো কিভাবে Custom Error Messages এবং Exception Handling ব্যবহার করে আর্গুমেন্ট পার্সিং এবং ব্যবহারকারীদের জন্য সঠিক আউটপুট প্রদান করা যায়।

1. Apache Commons CLI: Custom Error Message Handling

Custom Error Messages ব্যবহারকারীকে সঠিকভাবে বুঝাতে সাহায্য করে যে কোন আর্গুমেন্টটি ভুল দেওয়া হয়েছে এবং কীভাবে সেগুলো সঠিক করতে হবে। আপনি HelpFormatter ক্লাস ব্যবহার করে কাস্টম এরর বার্তা এবং সাহায্য বার্তা তৈরি করতে পারেন।

1.1. Custom Error Message এর উদাহরণ

import org.apache.commons.cli.*;

public class CommandLineExample {

    public static void main(String[] args) {
        // Option অবজেক্ট তৈরি করা
        Options options = new Options();

        // --name এবং --age অপশন তৈরি করা
        options.addOption("n", "name", true, "Your name");
        options.addOption("a", "age", true, "Your age");

        // CommandLineParser ব্যবহার করা
        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = null;

        try {
            // কমান্ড লাইন আর্গুমেন্ট পার্স করা
            cmd = parser.parse(options, args);

            // --name অপশন চেক করা
            if (!cmd.hasOption("n")) {
                System.out.println("Error: Name is required. Use -n or --name to specify your name.");
                printHelp(options);
                System.exit(1);
            }

            // --age অপশন চেক করা
            if (!cmd.hasOption("a")) {
                System.out.println("Error: Age is required. Use -a or --age to specify your age.");
                printHelp(options);
                System.exit(1);
            }

            // --name এবং --age অপশনের আর্গুমেন্ট বের করা
            String name = cmd.getOptionValue("n");
            String age = cmd.getOptionValue("a");

            // আউটপুট প্রিন্ট করা
            System.out.println("Name: " + name);
            System.out.println("Age: " + age);

        } catch (ParseException e) {
            System.out.println("Error: " + e.getMessage());
            printHelp(options);
            System.exit(1);
        }
    }

    // HelpFormatter ব্যবহার করে কাস্টম সাহায্য বার্তা
    private static void printHelp(Options options) {
        HelpFormatter formatter = new HelpFormatter();
        formatter.printHelp("CommandLineExample", options);
    }
}

ব্যাখ্যা:

• Custom Error Messages: System.out.println() এর মাধ্যমে কাস্টম এরর বার্তা প্রদর্শন করা হচ্ছে, যখন ব্যবহারকারী কোনো আর্গুমেন্ট বা অপশন না দেয়।
• HelpFormatter: HelpFormatter ব্যবহার করা হয়েছে, যাতে সঠিক আর্গুমেন্ট এবং অপশনগুলির সাহায্য বার্তা প্রদর্শিত হয়।
• System.exit(1): যখন কোনো ভুল হয়, তখন System.exit(1) এর মাধ্যমে প্রোগ্রামটি বন্ধ করা হয় এবং এরর কোড ফেরত দেয়া হয়।

আউটপুট উদাহরণ:

1. যদি আপনি আর্গুমেন্ট ছাড়া প্রোগ্রামটি চালান:

   java CommandLineExample
   

   আউটপুট:

   Error: Name is required. Use -n or --name to specify your name.
   Usage: CommandLineExample
    -a <age>     Your age
    -h, --help   Show help
    -n <name>    Your name
   

2. যদি --name বা --age অপশন ছাড়া প্রোগ্রামটি চালান:

   java CommandLineExample -n John
   

   আউটপুট:

   Error: Age is required. Use -a or --age to specify your age.
   Usage: CommandLineExample
    -a <age>     Your age
    -h, --help   Show help
    -n <name>    Your name
   

2. Exception Handling

Apache Commons CLI লাইব্রেরি একটি নির্দিষ্ট এক্সসেপশন (ParseException) ফেলে যখন আর্গুমেন্ট পার্সিংয়ের সময় কোনো সমস্যা হয়। এই এক্সসেপশনটি হ্যান্ডল করা গুরুত্বপূর্ণ, যাতে ব্যবহারকারীকে সঠিক বার্তা দেওয়া যায় এবং প্রোগ্রামটি ক্র্যাশ না হয়।

2.1. ParseException Handling এর উদাহরণ

import org.apache.commons.cli.*;

public class CommandLineExample {

    public static void main(String[] args) {
        // Option অবজেক্ট তৈরি করা
        Options options = new Options();

        // --name এবং --age অপশন তৈরি করা
        options.addOption("n", "name", true, "Your name");
        options.addOption("a", "age", true, "Your age");

        // CommandLineParser ব্যবহার করা
        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = null;

        try {
            // কমান্ড লাইন আর্গুমেন্ট পার্স করা
            cmd = parser.parse(options, args);

            // --name অপশন চেক করা
            if (cmd.hasOption("n")) {
                String name = cmd.getOptionValue("n");
                System.out.println("Name: " + name);
            } else {
                System.out.println("Error: Name is required.");
                printHelp(options);
                System.exit(1);
            }

            // --age অপশন চেক করা
            if (cmd.hasOption("a")) {
                String age = cmd.getOptionValue("a");
                System.out.println("Age: " + age);
            } else {
                System.out.println("Error: Age is required.");
                printHelp(options);
                System.exit(1);
            }

        } catch (ParseException e) {
            System.out.println("Error: Invalid command line arguments.");
            System.out.println("Reason: " + e.getMessage());
            printHelp(options);
            System.exit(1);
        }
    }

    // HelpFormatter ব্যবহার করে কাস্টম সাহায্য বার্তা
    private static void printHelp(Options options) {
        HelpFormatter formatter = new HelpFormatter();
        formatter.printHelp("CommandLineExample", options);
    }
}

ব্যাখ্যা:

• ParseException Handling: যদি আর্গুমেন্টগুলি সঠিকভাবে পার্স না হয়, তখন ParseException থ্রো হবে এবং তার মেসেজসহ কাস্টম এরর বার্তা প্রদর্শন করা হবে।
• Error Message: যদি কোনো আর্গুমেন্ট বা অপশন অনুপস্থিত থাকে, তাহলে ব্যবহারকারীর জন্য স্পষ্ট বার্তা প্রদর্শন করা হবে।

আউটপুট উদাহরণ:

1. যদি কোনো ভুল আর্গুমেন্ট দেওয়া হয়:

   java CommandLineExample -n John -x 30
   

   আউটপুট:

   Error: Invalid command line arguments.
   Reason: unrecognized option: -x
   Usage: CommandLineExample
    -a <age>     Your age
    -h, --help   Show help
    -n <name>    Your name
   

2. যদি সঠিক আর্গুমেন্ট না থাকে:

   java CommandLineExample -n John
   

   আউটপুট:

   Error: Age is required.
   Usage: CommandLineExample
    -a <age>     Your age
    -h, --help   Show help
    -n <name>    Your name
   

সারাংশ

Apache Commons CLI এর মাধ্যমে কমান্ড লাইন আর্গুমেন্ট পার্সিং এর সময় Custom Error Messages এবং Exception Handling খুবই গুরুত্বপূর্ণ। আপনি HelpFormatter ব্যবহার করে কাস্টম সাহায্য বার্তা এবং এরর মেসেজ তৈরি করতে পারেন, যা ব্যবহারকারীর জন্য কার্যকরী নির্দেশিকা প্রদান করবে। এছাড়া ParseException এর মাধ্যমে সঠিকভাবে এক্সসেপশন হ্যান্ডলিং করা যায়, যাতে ভুল আর্গুমেন্টের জন্য উপযুক্ত বার্তা প্রদর্শিত হয় এবং প্রোগ্রামটি ক্র্যাশ না হয়।

Apache Commons CLI লাইব্রেরি ব্যবহার করার সময় Command Line Parsing এর মধ্যে অনেক সময় বিভিন্ন ধরনের সমস্যা বা ত্রুটি (bugs) দেখা দিতে পারে। এই ধরনের সমস্যাগুলোর সমাধান করতে Debugging টেকনিকস ব্যবহার করা জরুরি। এখানে আমরা Apache Commons CLI ব্যবহার করে Command Line Parsing ডিবাগ করার জন্য কিছু গুরুত্বপূর্ণ টেকনিকস আলোচনা করব।

1. কমান্ড লাইন আর্গুমেন্টস প্রিন্ট করা

কখনও কখনও সমস্যা হয় যখন কমান্ড লাইন আর্গুমেন্টগুলি সঠিকভাবে পার্স হয় না বা অপশনগুলি সঠিকভাবে প্রদর্শিত হয় না। প্রথমে, আপনি কমান্ড লাইন আর্গুমেন্টস কে প্রিন্ট করে দেখতে পারেন যাতে নিশ্চিত হওয়া যায় যে সেগুলি ঠিকভাবে পাওয়া যাচ্ছে।

উদাহরণ:

public class CommandLineDebugExample {
    public static void main(String[] args) {
        // Print the command line arguments to debug
        System.out.println("Arguments: ");
        for (String arg : args) {
            System.out.println(arg);
        }
    }
}

এটি আপনাকে যেকোনো ভুল বা অপ্রত্যাশিত ইনপুট দেখতে সাহায্য করবে।

2. Apache Commons CLI Error Messages

যখন CommandLineParser ত্রুটি (error) পান, তখন এটি ParseException বা UnrecognizedOptionException এর মতো ত্রুটি ছুড়ে দেয়। এই ত্রুটিগুলি ধরা এবং সঠিকভাবে হ্যান্ডল করা খুবই গুরুত্বপূর্ণ, কারণ এগুলি ডিবাগ করার জন্য অনেক তথ্য সরবরাহ করে।

কমান্ড লাইন আর্গুমেন্টস পার্সিংয়ের সময় ত্রুটি হ্যান্ডলিং:

import org.apache.commons.cli.*;

public class CommandLineDebugExample {
    public static void main(String[] args) {
        Options options = new Options();

        // Define options
        options.addOption("f", "file", true, "Input file");
        options.addOption("v", "verbose", false, "Verbose output");

        CommandLineParser parser = new DefaultParser();
        CommandLine cmd = null;

        try {
            cmd = parser.parse(options, args);
        } catch (ParseException e) {
            System.err.println("Error parsing command line arguments: " + e.getMessage());
            HelpFormatter formatter = new HelpFormatter();
            formatter.printHelp("CommandLineDebugExample", options);
            return;
        }

        // Rest of the code
    }
}

ব্যাখ্যা:

• ParseException ব্যবহার করে কমান্ড লাইন পার্সিংয়ের সময় ত্রুটি ধরা হচ্ছে।
• ত্রুটি হলে, HelpFormatter ব্যবহার করে সঠিকভাবে help মেসেজ প্রদর্শন করা হচ্ছে।

3. Verbose Mode (Debugging Mode) চালু করা

বিভিন্ন অপশন এবং আর্গুমেন্ট ডিবাগ করার জন্য আপনি একটি verbose mode চালু করতে পারেন। এতে, অ্যাপ্লিকেশনটি বিভিন্ন অন্তর্নিহিত প্রক্রিয়া প্রিন্ট করবে, যা আপনাকে ডিবাগ করতে সহায়তা করবে।

উদাহরণ:

if (cmd.hasOption("v")) {
    System.out.println("Verbose mode enabled");
    System.out.println("Command Line Arguments:");
    for (Option option : cmd.getOptions()) {
        System.out.println("Option: " + option.getLongOpt() + ", Value: " + option.getValue());
    }
}

এখানে, verbose mode সক্ষম হলে, CommandLine আর্গুমেন্টগুলির সব অপশন এবং তাদের মান কনসোল আউটপুটে প্রিন্ট হবে।

4. Command Line Options Check

কখনও কখনও আপনার কমান্ড লাইন অপশন সঠিকভাবে চেক করা দরকার। বিভিন্ন অপশন ও তাদের আর্গুমেন্টের অবস্থা চেক করার জন্য একটি ফাংশন ব্যবহার করুন। এই চেকিং দ্বারা আপনি নিশ্চিত হতে পারবেন যে কোন অপশন দেয়া হয়েছে এবং কোনটি হয়নি।

উদাহরণ:

if (cmd.hasOption("f")) {
    System.out.println("File option provided: " + cmd.getOptionValue("f"));
} else {
    System.out.println("File option not provided");
}

if (cmd.hasOption("v")) {
    System.out.println("Verbose mode enabled");
}

এটি আপনাকে সঠিকভাবে দেখতে সাহায্য করবে, যদি কোনো অপশন বা আর্গুমেন্ট অনুপস্থিত থাকে বা ভুলভাবে প্রদান করা হয়।

5. Help Message Generation

HelpFormatter ব্যবহার করে help message প্রিন্ট করা খুবই কার্যকর। যদি ব্যবহারকারী ভুলভাবে আর্গুমেন্ট বা অপশন প্রদান করেন, তাহলে আপনি ব্যবহারকারীকে সঠিকভাবে সাহায্য করতে পারবেন।

HelpFormatter formatter = new HelpFormatter();
formatter.printHelp("CommandLineDebugExample", options);

এটি আপনাকে যে কোন ত্রুটির ক্ষেত্রে সাহায্য প্রদর্শন করতে এবং ব্যবহারকারীদের সঠিক অপশনগুলির জন্য নির্দেশনা দিতে সাহায্য করবে।

6. Invalid Option বা Missing Argument চেক করা

এটি সাধারণত ঘটে যখন একটি অপশন প্রদান করা হয় কিন্তু তার জন্য আর্গুমেন্ট সরবরাহ করা হয় না। আপনি এটি চেক করতে পারেন এবং ব্যবহারকারীকে উপযুক্ত বার্তা দিতে পারেন।

if (cmd.hasOption("f")) {
    String file = cmd.getOptionValue("f");
    if (file == null || file.isEmpty()) {
        System.err.println("Error: Missing argument for 'file' option");
    }
}

এখানে, যদি -f অপশনের জন্য আর্গুমেন্ট না দেওয়া হয়, তবে Error মেসেজ প্রদর্শন করা হবে।

7. Command Line Arguments লজিক চেক করা

আপনার কমান্ড লাইন আর্গুমেন্টস সঠিকভাবে পার্স করা হচ্ছে কিনা, তা চেক করতে উপযুক্ত লজিক প্রক্রিয়া ব্যবহার করুন। যদি আপনি কোনো আর্গুমেন্টের জন্য নির্দিষ্ট লজিক চান (যেমন, একটি ইনপুট ফাইলের নাম, যা কিছু নির্দিষ্ট ধরনের ডেটা গ্রহণ করবে), তাহলে সেই চেক করুন।

উদাহরণ:

String file = cmd.getOptionValue("f");
if (file != null) {
    if (!file.endsWith(".txt")) {
        System.err.println("Error: The file must have a .txt extension.");
    }
}

এখানে, ফাইলের নামের শেষে .txt এক্সটেনশন থাকা চেক করা হচ্ছে।

8. Exception Handling and Debugging Logs

আপনি যখন অনেকগুলো অপশন একসাথে ব্যবহার করছেন, তখন অনেক ধরনের এক্সসেপশন বা ত্রুটি ঘটতে পারে। এমন সময় exception handling এবং debugging logs সহায়তা করতে পারে।

try {
    cmd = parser.parse(options, args);
} catch (ParseException e) {
    System.err.println("Parse Error: " + e.getMessage());
    e.printStackTrace();  // Detailed stack trace for debugging
    HelpFormatter formatter = new HelpFormatter();
    formatter.printHelp("CommandLineParserExample", options);
}

এখানে, stack trace ব্যবহার করা হয়েছে যা ত্রুটির বিস্তারিত তথ্য প্রদান করবে।

9. Common Errors and Debugging Tips

• Unrecognized Option: নিশ্চিত করুন যে আপনি সঠিক অপশন নাম ব্যবহার করছেন এবং সেগুলি Options এ যুক্ত করেছেন।
• Missing Arguments: নিশ্চিত করুন যে আপনি যেকোনো অপশনের জন্য যথাযথ আর্গুমেন্ট প্রদান করছেন।
• Invalid Argument Types: নিশ্চিত করুন যে আপনি সঠিক ডেটা টাইপের আর্গুমেন্ট প্রদান করছেন (যেমন, পূর্ণসংখ্যা বা স্ট্রিং)।

সারাংশ

Apache Commons CLI এর মাধ্যমে কমান্ড লাইন আর্গুমেন্ট পার্সিংয়ের সময় debugging অত্যন্ত গুরুত্বপূর্ণ। আপনি Command Line Parsing ডিবাগ করার জন্য HelpFormatter, Verbose Mode, Error Handling, Option Checking, এবং Debug Logs ব্যবহার করতে পারেন। এই পদ্ধতিগুলি আপনাকে সমস্যাগুলিকে দ্রুত শনাক্ত করতে এবং ব্যবহারকারীকে সহায়তা প্রদান করতে সহায়ক হবে।