Third command-line tutorial

Overview

This tutorial is building upon the second command-line tutorial. We will learn to:

• Don't show the application window if a specific argumentGroup is detected

Specify the xml file to specify the command-line arguments for the Plugin

We will change the command-line arguments for the Plugin by adding an analyze argumpent group:

• This argument group will be used to analyze an image without opening the application

To achieve this, we will use an argument group:

   <arguments>
      <argument key="open" type="empty" />
      <argument key="analyze" type="empty" />
      <argument key="image" type="url" />
      <argumentGroup key="open">
         <argument key="open" mandatory="true" />
         <argument key="image" mandatory="true" />
      </argumentGroup>
      <argumentGroup key="analyze" preventOpening="true">
         <argument key="analyze" mandatory="true" />
         <argument key="image" mandatory="true" />
      </argumentGroup>    
   </arguments>

Use the command-line framework in our Plugin

We don't change the usage of the xml file in our plugin from the previous tutorial.

We now will use the arguments in the Plugin. If we encounter the analyze argument group, we will not open the application so kin our example we will show the characteristics of the image on the console:

   public class OpenImagePlugin extends AbstractMDIPlugin {
      
     @Override
     public void handleCommandLineArguments(Map<String, ArgumentGroup> argumentGroups, Map<String, Argument> arguments) {
       if (argumentGroups.containsKey("open")) {
         ArgumentGroup group = argumentGroups.get("open");
         File file = (File) group.getArgument("image").getValue();
         try {
           importImage(file);
         } catch (Exception ex) {
           ex.printStackTrace();
         }
       } else if (argumentGroups.containsKey("analyze")) {
         try {
           ArgumentGroup group = argumentGroups.get("analyze");
           File file = (File) group.getArgument("image").getValue();
           AppliConfiguration conf = AppliConfiguration.getInstance();
           conf.lastDir = file.getParentFile();
           BufferedImage image = ImageIO.read(file);  
           System.out.println("Width: " + image.getWidth() + ", Height: " + image.getHeight());
         } catch (IOException ex) {
           System.err.println("Bad File type");
         }   
       }
     }    
   }

Usage

We can still start our application with the sizeX and sizeY arguments, such as: Or we can use the sizeX and sizeY arguments, such as:

      java -jar CommandlineTutorial2MDI.jar -sizeX=500 -sizeY=500

But now we can also start the application and open an image file, such with:

      java -jar CommandlineTutorial2MDI.jar -open -image=myImage.jpg

In this third example, we will not show the application:

      java -jar CommandlineTutorial2MDI.jar -analyze -image=myImage.jpg