net.rim.device.api.ui.text
Class IPTextFilter

java.lang.Object
  |
  +--net.rim.device.api.ui.text.TextFilter
        |
        +--net.rim.device.api.ui.text.IPTextFilter

public class IPTextFilter

extends TextFilter

Filters out characters not used in IP\Port text strings It accepts only number, dot and colon characters. Also restricts number of points to 3 and number of colons to 2.

Field Summary

static int	NO_PORTS
static int	NUMERIC_IP_ONLY

Fields inherited from class net.rim.device.api.ui.text.TextFilter

DEFAULT, EMAIL, HEXADECIMAL, INTEGER, LOWERCASE, NUMERIC, PHONE, UPPERCASE, URL

Constructor Summary

IPTextFilter()
Constructs new IPTextFilter object with no parameters.

IPTextFilter(int flag)
Constructs new IPTextFilter object.

Method Summary

char	convert(char character, int status) Retrieves filtered version of provided character.
boolean	validate(AbstractString text) Determines if provided string contains valid characters.
boolean	validate(char character) Validates character for use with this filter.

Methods inherited from class net.rim.device.api.ui.text.TextFilter

get

Methods inherited from class java.lang.Object

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

Field Detail

NO_PORTS

public static final int NO_PORTS

NUMERIC_IP_ONLY

public static final int NUMERIC_IP_ONLY

Constructor Detail

IPTextFilter

public IPTextFilter()

Constructs new IPTextFilter object with no parameters.

IPTextFilter

public IPTextFilter(int flag)

Constructs new IPTextFilter object. Takes an argument that specifies if UDP ports are alowed.

Parameters:

flag -

Method Detail

convert

public char convert(char character,
                    int status)

Description copied from class: TextFilter

Retrieves filtered version of provided character.

This method may not return a character valid for this filter; however, it may return 0 to indicate that the provided character is not valid.

For example, an UppercaseTextFilter would convert any lower case character to its upper case equivalent. However, if passed a number it could either leave the number unchanged to be filtered by TextFilter.validate(char), or convert it to \u0000.

Overrides:

convert in class TextFilter

Since:

JDE 3.6

validate

public boolean validate(AbstractString text)

Description copied from class: TextFilter

Determines if provided string contains valid characters.

The default implementation of this method returns true if each character is valid within the field (determined by invoking TextFilter.validate(char). This is useful for upper case or lower case filters, for example, but filters that rely on character position must override this method.

Overrides:

validate in class TextFilter

Since:

JDE 3.6

validate

public boolean validate(char character)

Description copied from class: TextFilter

Validates character for use with this filter.

This only considers if it is in the correct set of characters.

Overrides:

validate in class TextFilter

Since:

JDE 3.6