public interface

HttpParams

org.apache.http.params.HttpParams
Known Indirect Subclasses

Class Overview

HttpParams interface represents a collection of immutable values that define a runtime behavior of a component. HTTP parameters should be simple objects: integers, doubles, strings, collections and objects that remain immutable at runtime. HttpParams is expected to be used in the 'write once - ready many' mode. Once initialized HTTP parameters are not expected to mutate in the course of HTTP message processing.

The purpose of this intreface is to define a behavior of other components. Usually each complex component has its own HTTP parameter collection.

Instances of this interface can be linked together to form a hierarchy. In the simplest form one set of parameters can use content of another one to obtain default values of parameters not present in the local set.

Summary

Public Methods
abstract HttpParams copy()
This method is deprecated. No replacement.
abstract boolean getBooleanParameter(String name, boolean defaultValue)
Returns a Boolean parameter value with the given name.
abstract double getDoubleParameter(String name, double defaultValue)
Returns a Double parameter value with the given name.
abstract int getIntParameter(String name, int defaultValue)
Returns an Integer parameter value with the given name.
abstract long getLongParameter(String name, long defaultValue)
Returns a Long parameter value with the given name.
abstract Object getParameter(String name)
Obtains the value of the given parameter.
abstract boolean isParameterFalse(String name)
Checks if a boolean parameter is not set or false.
abstract boolean isParameterTrue(String name)
Checks if a boolean parameter is set to true.
abstract boolean removeParameter(String name)
Removes the parameter with the specified name.
abstract HttpParams setBooleanParameter(String name, boolean value)
Assigns a Boolean to the parameter with the given name
abstract HttpParams setDoubleParameter(String name, double value)
Assigns a Double to the parameter with the given name
abstract HttpParams setIntParameter(String name, int value)
Assigns an Integer to the parameter with the given name
abstract HttpParams setLongParameter(String name, long value)
Assigns a Long to the parameter with the given name
abstract HttpParams setParameter(String name, Object value)
Assigns the value to the parameter with the given name.

Public Methods

public abstract HttpParams copy ()

This method is deprecated.
No replacement.

Creates a copy of these parameters.

Returns
  • a new set of parameters holding the same values as this one

public abstract boolean getBooleanParameter (String name, boolean defaultValue)

Returns a Boolean parameter value with the given name. If the parameter is not explicitly set, the default value is returned.

Parameters
name the parent name.
defaultValue the default value.
Returns
  • a Boolean that represents the value of the parameter.

public abstract double getDoubleParameter (String name, double defaultValue)

Returns a Double parameter value with the given name. If the parameter is not explicitly set, the default value is returned.

Parameters
name the parent name.
defaultValue the default value.
Returns
  • a Double that represents the value of the parameter.

public abstract int getIntParameter (String name, int defaultValue)

Returns an Integer parameter value with the given name. If the parameter is not explicitly set, the default value is returned.

Parameters
name the parent name.
defaultValue the default value.
Returns
  • a Integer that represents the value of the parameter.

public abstract long getLongParameter (String name, long defaultValue)

Returns a Long parameter value with the given name. If the parameter is not explicitly set, the default value is returned.

Parameters
name the parent name.
defaultValue the default value.
Returns
  • a Long that represents the value of the parameter.

public abstract Object getParameter (String name)

Obtains the value of the given parameter.

Parameters
name the parent name.
Returns
  • an object that represents the value of the parameter, null if the parameter is not set or if it is explicitly set to null

public abstract boolean isParameterFalse (String name)

Checks if a boolean parameter is not set or false.

Parameters
name parameter name
Returns
  • true if the parameter is either not set or set to value false, false if it is set to true

public abstract boolean isParameterTrue (String name)

Checks if a boolean parameter is set to true.

Parameters
name parameter name
Returns
  • true if the parameter is set to value true, false if it is not set or set to false

public abstract boolean removeParameter (String name)

Removes the parameter with the specified name.

Parameters
name parameter name
Returns
  • true if the parameter existed and has been removed, false else.

public abstract HttpParams setBooleanParameter (String name, boolean value)

Assigns a Boolean to the parameter with the given name

Parameters
name parameter name
value parameter value

public abstract HttpParams setDoubleParameter (String name, double value)

Assigns a Double to the parameter with the given name

Parameters
name parameter name
value parameter value

public abstract HttpParams setIntParameter (String name, int value)

Assigns an Integer to the parameter with the given name

Parameters
name parameter name
value parameter value

public abstract HttpParams setLongParameter (String name, long value)

Assigns a Long to the parameter with the given name

Parameters
name parameter name
value parameter value

public abstract HttpParams setParameter (String name, Object value)

Assigns the value to the parameter with the given name.

Parameters
name parameter name
value parameter value