com.google.gdata.client.calendar

Class CalendarQuery.ExtendedPropertyMatch

java.lang.Object

com.google.gdata.client.calendar.CalendarQuery.ExtendedPropertyMatch

Enclosing class:

CalendarQuery

public static class CalendarQuery.ExtendedPropertyMatch
extends Object

The ExtendedPropertyMatch class corresponds to a single extended property match.

See Also:

CalendarQuery.setExtendedPropertyQuery( CalendarQuery.ExtendedPropertyMatch...), CalendarQuery.getExtendedPropertyQuery()

Field Summary

Fields

Modifier and Type	Field and Description
static Pattern	EXT_PROP_QUERY_PATTERN A pattern that matches exactly one extended property query within a compound extended property query.
static int	MAX_EXTENDED_PROPERTY_NAME_LENGTH The maximum length of an extended property name.
static int	MAX_EXTENDED_PROPERTY_VALUE_LENGTH The maximum length of an extended property value (after escaped characters have been converted into plain characters, e.g.
static String	PROPERTY_NAME_REGEX A regex describing the format of extended property names.
static String	PROPERTY_VALUE_REGEX A regex describing the format of extended property values.
static String	SINGLE_EXT_PROP_QUERY_REGEX Group 1: property name (without :'s and ='s).

Constructor Summary

Constructors

Constructor and Description
CalendarQuery.ExtendedPropertyMatch(String name, String value)

Method Summary

Methods

Modifier and Type	Method and Description
static CalendarQuery.ExtendedPropertyMatch[]	arrayFromExtendedPropertyQueryString(String extqQuery) Converts strings of the form "[foo:bar][baz:bin]" to a map of "foo"->"bar" and "baz"->"bin".
boolean	equals(Object other)
String	getExpression()
String	getName()
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MAX_EXTENDED_PROPERTY_NAME_LENGTH

public static final int MAX_EXTENDED_PROPERTY_NAME_LENGTH

The maximum length of an extended property name.

See Also:

Constant Field Values

MAX_EXTENDED_PROPERTY_VALUE_LENGTH

public static final int MAX_EXTENDED_PROPERTY_VALUE_LENGTH

The maximum length of an extended property value (after escaped characters have been converted into plain characters, e.g. \" -> ").

See Also:

Constant Field Values

PROPERTY_NAME_REGEX

public static final String PROPERTY_NAME_REGEX

A regex describing the format of extended property names. The name can be a plain string without :'s and ='s.

See Also:

Constant Field Values

PROPERTY_VALUE_REGEX

public static final String PROPERTY_VALUE_REGEX

A regex describing the format of extended property values. The value can be:

• a (possibly empty) plain string without ]'s (e.g. Foo Property), or
• a (possibly empty) quoted string with back slashes and quotes escaped by back slashes (e.g. "\"[Property name]\"").

See Also:

Constant Field Values

SINGLE_EXT_PROP_QUERY_REGEX

public static final String SINGLE_EXT_PROP_QUERY_REGEX

Group 1: property name (without :'s and ='s). Group 2: property value (perhaps with surrounding quotes which should be stripped off).

See Also:

Constant Field Values

EXT_PROP_QUERY_PATTERN

public static final Pattern EXT_PROP_QUERY_PATTERN

A pattern that matches exactly one extended property query within a compound extended property query. E.g. when applied to "[foo:bar][baz:"bin"]", it will consecutively match:

1. [foo:bar] (group1: foo, group2: bar).
2. [baz:"bin"] (group1: baz, group2: "bin". Please note that the quotes surrounding 'bin' also belong in the group text and should be stripped prior to further processing of the property value).

Constructor Detail

CalendarQuery.ExtendedPropertyMatch

public CalendarQuery.ExtendedPropertyMatch(String name,
                                   String value)

Parameters:

name - extended property name. May contain up to 44 characters and may not contain ':' or '=' characters.

value - to match against the name extended property. May contain up to 1024 characters.

Method Detail

getName

public String getName()

getExpression

public String getExpression()

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

arrayFromExtendedPropertyQueryString

public static CalendarQuery.ExtendedPropertyMatch[] arrayFromExtendedPropertyQueryString(String extqQuery)

Converts strings of the form "[foo:bar][baz:bin]" to a map of "foo"->"bar" and "baz"->"bin". Ignores quotation marks around values but not around keys. Unescapes backslash-escaped characters.

Parameters:

extqQuery - a non-null query string.

Returns:

array of CalendarQuery.ExtendedPropertyMatch.

Throws:

IllegalArgumentException - whenever the extended property query syntax passed in is invalid.