Class GetOpt
- java.lang.Object
-
- netscape.ldap.util.GetOpt
-
- All Implemented Interfaces:
java.io.Serializable
public class GetOpt extends java.lang.Object implements java.io.Serializable
This class is similar to thegetopt()
function in UNIX System V. You can use this class to parse command-line arguments.When you create an object of this class, you specify a string containing the command-line options that you want to check for. The string should contain the letters of these options. If an option requires an argument (for example, "-h
"), you should add a colon after the letter in this string. For example, in the following string, the
-h
,-p
,-D,
, and-w
options all require arguments. The-H
option does not require any arguments."h:p:D:w:H"
You can use thehasOption
method to determine if an option has been specified and thegetOptionParam
method to get the argument specified after a particular option.If an option not specified in the string is passed in as an argument, the
GetOpt
object prints out an error message. Note that the object does not throw an exception or exit the application if an invalid option is specified.Note that you are still responsible for verifying that any required arguments have been specified.
The following example parses the command-line arguments for the hostname, port number, DN, and password to use when connecting and authenticating to an LDAP server.
import netscape.ldap.*; import netscape.ldap.controls.*; import netscape.ldap.util.*; import java.util.*; public class SearchDirectory { public static void main( String[] args ) { String usage = "Usage: java SearchDirectory -h
-p " + "[-D ] [-w ]" int portnumber = LDAPv2.DEFAULT_PORT; // Check for these options. -H means to print out a usage message. GetOpt options = new GetOpt( "h:p:D:w:H", args ); // Get the arguments specified for each option. String hostname = options.getOptionParam( 'h' ); String port = options.getOptionParam( 'p' ); String bindDN = options.getOptionParam( 'D' ); String bindPW = options.getOptionParam( 'w' ); // Check to see if the hostname (which is mandatory) // is not specified or if the user simply wants to // see the usage message (-H). if ( hostname == null || options.hasOption( 'H' ) ) { System.out.println( usage ); System.exit( 1 ); } // If a port number was specified, convert the port value // to an integer. if ( port != null ) { try { portnumber = java.lang.Integer.parseInt( port ); } catch ( java.lang.Exception e ) { System.out.println( "Invalid port number: " + port ); System.out.println( usage ); System.exit( 1 ); } } // Create a new connection. LDAPConnection ld = new LDAPConnection(); try { // Connect and authenticate to server. ld.connect( 3, hostname, portnumber, bindDN, bindPW ); ... } catch ( LDAPException e ) { System.out.println( "Error: " + e.toString() ); } ... } } - Version:
- 1.0
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description GetOpt(java.lang.String strControl, java.lang.String[] args)
Constructs aGetOpt
object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.String
getOptionParam(char c)
Gets the argument specified with an option.java.util.Vector<java.lang.String>
getParameters()
Gets a list of any additional parameters specified (not including the arguments for any options).boolean
hasOption(char c)
Determines if an option was specified.
-
-
-
Constructor Detail
-
GetOpt
public GetOpt(java.lang.String strControl, java.lang.String[] args)
Constructs aGetOpt
object.- Parameters:
strControl
- a string specifying the letters of all available options. If an option requires an argument (for example, "-h"), use a colon after the letter for that option (for example, "h:p:D:w:H"). args
- an array of strings representing the list of arguments to parse (for example, the array passed into Main).
-
-
Method Detail
-
hasOption
public boolean hasOption(char c)
Determines if an option was specified. For example,hasOption( 'H' )
checks if the -H option was specified.- Parameters:
c
- letter of the option to check- Returns:
true
if the option was specified.
-
getOptionParam
public java.lang.String getOptionParam(char c)
Gets the argument specified with an option. For example,getOptionParameter( 'h' )
gets the value of the argument specified with the -h option (such as "localhost" in "-h localhost").- Parameters:
c
- the letter of the option to check- Returns:
- the argument specified for this option.
-
getParameters
public java.util.Vector<java.lang.String> getParameters()
Gets a list of any additional parameters specified (not including the arguments for any options).- Returns:
- a list of the additional parameters.
-
-