org.netbeans.spi.sendopts

Class OptionProcessor

java.lang.Object

org.netbeans.spi.sendopts.OptionProcessor

public abstract class OptionProcessor
extends Object

A subclass of this class shall be registered using ServiceProvider in order to register it for participation on handling and processing of command line options initiated by CommandLine.getDefault()'s CommandLine.process(java.lang.String...). When the Options provided by this processor are found on the command line and are consistent, this processor's OptionProcessor.process(org.netbeans.spi.sendopts.Env, java.util.Map<org.netbeans.spi.sendopts.Option, java.lang.String[]>) method is going to be called to handle their values and invoke an action.

Looking forward: consider using declarative annotations for registering your options more effectively.

The usual pattern for writing a subclass of processor is:

  @ServiceProvider(service=OptionProcessor.class)
 public class MyProcessor extends OptionProcessor {
   private Option option1 = ...;
   private Option option2 = ...;
   private Option option3 = ...;
 
   protected Set<Option> getOptions() {
      Set<Option> set = new HashSet<Option>();
      set.add(option1);
      set.add(option2);
      set.add(option3);
      return set;
   }
 
   protected void process(Env env, Map<Option,String[]> values) 
       throws CommandException {
     if (values.containsKey(option1)) { ... }
     if (values.containsKey(option2)) { ... }
     if (values.containsKey(option3)) { ... }
   }
 }
 

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	OptionProcessor() Constructor for subclasses.

Method Summary

Modifier and Type	Method and Description
protected abstract Set<Option>	getOptions() Method to override in subclasses to create the right set of Options.
protected abstract void	process(Env env, Map<Option,String[]> optionValues) Called by the sendopts parsing infrastructure as a result of CommandLine.process(java.lang.String...).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OptionProcessor

protected OptionProcessor()

Constructor for subclasses.

Method Detail

getOptions

protected abstract Set<Option> getOptions()

Method to override in subclasses to create the right set of Options. See the factory methods that are part of the Option's javadoc or read the usecases for the sendopts API.

Returns:

a set of options this processor is interested in, if during processing at least on of the options appears on command line the OptionProcessor.process(org.netbeans.spi.sendopts.Env, java.util.Map<org.netbeans.spi.sendopts.Option, java.lang.String[]>) method will be invoked to handle such option and its values

process

protected abstract void process(Env env,
                                Map<Option,String[]> optionValues)
                         throws CommandException

Called by the sendopts parsing infrastructure as a result of CommandLine.process(java.lang.String...). The method shall read the values associated with the option(s) this OptionProcessor defines and invoke an action to handle them. While doing this it can communicate with external world using its environment (see Env). Such environment provides access to current user directory, standard output and error streams, as well standard input stream. In case the processing of options fails, the code shall thrown CommandException.

Parameters:

env - the environment to communicate with

optionValues - map of all options that appeared on command line with their values

Throws:

CommandException - in case the processing fails1