/** * Returns the value of the attribute specified by its name as a * <code>String</code>. * * @param name the name of the attribute * @param defaultValue the default value to return if value malformed or empty * @return the value */ public String getAttribute( final String name, final String defaultValue ) { try { return getAttribute( name ); } catch( final ConfigurationException ce ) { return defaultValue; } }
/** * Returns the value of the attribute specified by its name as a * <code>boolean</code>. * * @param name the name of the attribute * @param defaultValue the default value to return if value malformed or empty * @return the value */ public boolean getAttributeAsBoolean( final String name, final boolean defaultValue ) { try { return getAttributeAsBoolean( name ); } catch( final ConfigurationException ce ) { return defaultValue; } }
/** * Returns the value of the attribute specified by its name as a * <code>double</code>. * * @param name the name of the attribute * @param defaultValue the default value to return if value malformed or empty * @return the value */ public double getAttributeAsDouble( final String name, final double defaultValue ) { try { return getAttributeAsDouble( name ); } catch( final ConfigurationException ce ) { return defaultValue; } }
/** * The toString() operation is used for debugging information. It does * not create a deep reproduction of this configuration and all child configurations, * instead it displays the name, value, and location. * * @return getName() + "::" + getValue() + ":@" + getLocation(); */ public String toString() { return getName() + "::" + getValue("<no value>") + ":@" + getLocation(); } }
/** * Returns the value of the configuration element as a <code>boolean</code>. * * @throws ConfigurationException if an error occurs * @return the value */ public boolean getValueAsBoolean() throws ConfigurationException { final String value = getValue().trim(); if( isTrue( value ) ) { return true; } else if( isFalse( value ) ) { return false; } else { final String message = "Cannot parse the value \"" + value + "\" as a boolean in the configuration element \"" + getName() + "\" at " + getLocation(); throw new ConfigurationException( message ); } }
/** * Returns the value of the attribute specified by its name as a * <code>boolean</code>. * * @param name the name of the attribute * @throws ConfigurationException if an error occurs * @return the value */ public boolean getAttributeAsBoolean( final String name ) throws ConfigurationException { final String value = getAttribute( name ); if( isTrue( value ) ) { return true; } else if( isFalse( value ) ) { return false; } else { final String message = "Cannot parse the value \"" + value + "\" as a boolean in the attribute \"" + name + "\" at " + getLocation(); throw new ConfigurationException( message ); } }
/** * Returns the value of the attribute specified by its name as a * <code>float</code>. * * @param name the name of the attribute * @throws ConfigurationException if an error occurs * @return the value */ public float getAttributeAsFloat( final String name ) throws ConfigurationException { final String value = getAttribute( name ); try { return Float.parseFloat( value ); } catch( final Exception e ) { final String message = "Cannot parse the value \"" + value + "\" as a float in the attribute \"" + name + "\" at " + getLocation(); throw new ConfigurationException( message ); } }
/** * Return the first <code>Configuration</code> object child of this * associated with the given name. If no such child exists, a new one * will be created. * * @param name the name of the child * @return the child Configuration */ public Configuration getChild( final String name ) { return getChild( name, true ); }
/** * Returns the value of the attribute specified by its name as an * <code>int</code>. * * Hexadecimal numbers begin with 0x, Octal numbers begin with 0o and binary * numbers begin with 0b, all other values are assumed to be decimal. * * @param name the name of the attribute * @param defaultValue the default value to return if value malformed or empty * @return the value */ public int getAttributeAsInteger( final String name, final int defaultValue ) { try { return getAttributeAsInteger( name ); } catch( final ConfigurationException ce ) { return defaultValue; } }
/** * Returns the value of the attribute specified by its name as a * <code>float</code>. * * @param name the name of the attribute * @param defaultValue the default value to return if value malformed or empty * @return the value */ public float getAttributeAsFloat( final String name, final float defaultValue ) { try { return getAttributeAsFloat( name ); } catch( final ConfigurationException ce ) { return defaultValue; } }
/** * Returns the value of the attribute specified by its name as a * <code>long</code>. * * Hexadecimal numbers begin with 0x, Octal numbers begin with 0o and binary * numbers begin with 0b, all other values are assumed to be decimal. * * @param name the name of the attribute * @param defaultValue the default value to return if value malformed or empty * @return the value */ public long getAttributeAsLong( final String name, final long defaultValue ) { try { return getAttributeAsLong( name ); } catch( final ConfigurationException ce ) { return defaultValue; } }
/** * Return the first <code>Configuration</code> object child of this * associated with the given name. * * @param name the name of the child * @param createNew true if you want to create a new Configuration object if none exists * @return the child Configuration */ public Configuration getChild( final String name, final boolean createNew ) { final Configuration[] children = getChildren( name ); if( children.length > 0 ) { return children[ 0 ]; } else { if( createNew ) { return new DefaultConfiguration( name, "-" ); } else { return null; } } }
/** * Returns the value of the configuration element as a <code>float</code>. * * @throws ConfigurationException if an error occurs * @return the value */ public float getValueAsFloat() throws ConfigurationException { final String value = getValue().trim(); try { return Float.parseFloat( value ); } catch( final Exception nfe ) { final String message = "Cannot parse the value \"" + value + "\" as a float in the configuration element \"" + getName() + "\" at " + getLocation(); throw new ConfigurationException( message ); } }
/** * Returns the value of the attribute specified by its name as a * <code>double</code>. * * @param name the name of the attribute * @throws ConfigurationException if an error occurs * @return the value */ public double getAttributeAsDouble( final String name ) throws ConfigurationException { final String value = getAttribute( name ); try { return Double.parseDouble( value ); } catch( final Exception e ) { final String message = "Cannot parse the value \"" + value + "\" as a double in the attribute \"" + name + "\" at " + getLocation(); throw new ConfigurationException( message ); } }
/** * Returns the value of the configuration element as a <code>double</code>. * * @throws ConfigurationException if an error occurs * @return the value */ public double getValueAsDouble() throws ConfigurationException { final String value = getValue().trim(); try { return Double.parseDouble( value ); } catch( final Exception nfe ) { final String message = "Cannot parse the value \"" + value + "\" as a double in the configuration element \"" + getName() + "\" at " + getLocation(); throw new ConfigurationException( message ); } }
throws ConfigurationException final String value = getAttribute( name ); "Cannot parse the value \"" + value + "\" as a long in the attribute \"" + name + "\" at " + getLocation(); throw new ConfigurationException( message );
throws ConfigurationException final String value = getValue().trim(); try "Cannot parse the value \"" + value + "\" as a long in the configuration element \"" + getName() + "\" at " + getLocation(); throw new ConfigurationException( message );
throws ConfigurationException final String value = getAttribute( name ).trim(); try "Cannot parse the value \"" + value + "\" as an integer in the attribute \"" + name + "\" at " + getLocation(); throw new ConfigurationException( message );
throws ConfigurationException final String value = getValue().trim(); try "Cannot parse the value \"" + value + "\" as an integer in the configuration element \"" + getName() + "\" at " + getLocation(); throw new ConfigurationException( message );