Package com.itextpdf.xmp.options
Class Options
java.lang.Object
com.itextpdf.xmp.options.Options
- Direct Known Subclasses:
AliasOptions
,IteratorOptions
,ParseOptions
,PropertyOptions
,SerializeOptions
The base class for a collection of 32 flag bits. Individual flags are defined as enum value bit
masks. Inheriting classes add convenience accessor methods.
- Since:
- 24.01.2006
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate Map
a map containing the bit namesprivate int
the internal int containing all options -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected void
assertConsistency
(int options) The inheriting option class can do additional checks on the options.private void
assertOptionsValid
(int options) Checks options before they are set.void
clear()
Resets the options.boolean
containsAllOptions
(int optionBits) boolean
containsOneOf
(int optionBits) protected abstract String
defineOptionName
(int option) To be implemeted by inheritants.boolean
protected boolean
getOption
(int optionBit) private String
getOptionName
(int option) Looks up or asks the inherited class for the name of an option bit.int
Is friendly to access it during the tests.Creates a human readable string from the set options.protected abstract int
To be implemeted by inheritants.int
hashCode()
boolean
isExactly
(int optionBits) private Map
void
setOption
(int optionBits, boolean value) void
setOptions
(int options) toString()
-
Field Details
-
options
private int optionsthe internal int containing all options -
optionNames
a map containing the bit names
-
-
Constructor Details
-
Options
public Options()The default constructor. -
Options
Constructor with the options bit mask.- Parameters:
options
- the options bit mask- Throws:
XMPException
- If the options are not correct
-
-
Method Details
-
clear
public void clear()Resets the options. -
isExactly
public boolean isExactly(int optionBits) - Parameters:
optionBits
- an option bitmask- Returns:
- Returns true, if this object is equal to the given options.
-
containsAllOptions
public boolean containsAllOptions(int optionBits) - Parameters:
optionBits
- an option bitmask- Returns:
- Returns true, if this object contains all given options.
-
containsOneOf
public boolean containsOneOf(int optionBits) - Parameters:
optionBits
- an option bitmask- Returns:
- Returns true, if this object contain at least one of the given options.
-
getOption
protected boolean getOption(int optionBit) - Parameters:
optionBit
- the binary bit or bits that are requested- Returns:
- Returns if
all of the requested bits are set or not.
-
setOption
public void setOption(int optionBits, boolean value) - Parameters:
optionBits
- the binary bit or bits that shall be set to the given valuevalue
- the boolean value to set
-
getOptions
public int getOptions()Is friendly to access it during the tests.- Returns:
- Returns the options.
-
setOptions
- Parameters:
options
- The options to set.- Throws:
XMPException
-
equals
-
hashCode
public int hashCode() -
getOptionsString
Creates a human readable string from the set options. Note: This method is quite expensive and should only be used within tests or as- Returns:
- Returns a String listing all options that are set to
true
by their name, like "option1 | option4".
-
toString
-
getValidOptions
protected abstract int getValidOptions()To be implemeted by inheritants.- Returns:
- Returns a bit mask where all valid option bits are set.
-
defineOptionName
To be implemeted by inheritants.- Parameters:
option
- a single, valid option bit.- Returns:
- Returns a human readable name for an option bit.
-
assertConsistency
The inheriting option class can do additional checks on the options. Note: For performance reasons this method is only called when setting bitmasks directly. When get- and set-methods are used, this method must be called manually, normally only when the Options-object has been created from a client (it has to be made public therefore).- Parameters:
options
- the bitmask to check.- Throws:
XMPException
- Thrown if the options are not consistent.
-
assertOptionsValid
Checks options before they are set. First it is checked if only defined options are used, second the additionalassertConsistency(int)
-method is called.- Parameters:
options
- the options to check- Throws:
XMPException
- Thrown if the options are invalid.
-
getOptionName
Looks up or asks the inherited class for the name of an option bit. Its save that there is only one valid option handed into the method.- Parameters:
option
- a single option bit- Returns:
- Returns the option name or undefined.
-
procureOptionNames
- Returns:
- Returns the optionNames map and creates it if required.
-