org.docx4j.model.sdt

Class QueryString

java.lang.Object

org.docx4j.model.sdt.QueryString

public class QueryString
extends java.lang.Object

There is no standard for how more than one value should be stored in w:/sdtPr/w:tag This class stores them like a URL query string If all apps were to do that, two different applications which stored data to w:tag could possibly co-exist. To that end, it is recommended you use a namespace (ie somenamespace: ) as part of each of your keys. Note that Word 2007 limits the length of an w:sdtPr/w:tag to 64 characters, so you may wish to keep to that length.

Constructor Summary

Constructors

Constructor and Description
QueryString()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	create(java.util.Map<java.lang.String,java.lang.String> map) Encode the map as a query string, suitable for storing in w:/sdtPr/w:tag Note that if you intend to use unmarshalString on this, you'll first need to encode the '&' as '&'
static java.util.HashMap<java.lang.String,java.lang.String>	parseQueryString(java.lang.String s)
static java.util.HashMap<java.lang.String,java.lang.String>	parseQueryString(java.lang.String s, boolean lax) Parses a query string passed from the client to the server and builds a HashTable object with key-value pairs.

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryString

public QueryString()

Method Detail

create

public static java.lang.String create(java.util.Map<java.lang.String,java.lang.String> map)

Encode the map as a query string, suitable for storing in w:/sdtPr/w:tag Note that if you intend to use unmarshalString on this, you'll first need to encode the '&' as '&'

Parameters:

map -

Returns:

parseQueryString

public static java.util.HashMap<java.lang.String,java.lang.String> parseQueryString(java.lang.String s)

parseQueryString

public static java.util.HashMap<java.lang.String,java.lang.String> parseQueryString(java.lang.String s,
                                                                                    boolean lax)

Parses a query string passed from the client to the server and builds a HashTable object with key-value pairs. The query string should be in the form of a string packaged by the GET or POST method, that is, it should have key-value pairs in the form key=value, with each pair separated from the next by a & character.

A key can appear more than once in the query string with different values. However, the key appears only once in the hashtable, with its value being an array of strings containing the multiple values sent by the query string.

When the keys (only - *not* values) are moved into the hashtable, any + characters are converted to spaces, and characters sent in hexadecimal notation (like %xx) are converted to ASCII characters. This method adapted from Java sources

Parameters:

s - a string containing the query to be parsed

Returns:

a HashTable object built from the parsed key-value pairs

Throws:

java.lang.IllegalArgumentException - if the query string is invalid