Package org.apache.tapestry5.services
Interface ContextPathEncoder
- All Known Implementing Classes:
ContextPathEncoderImpl
public interface ContextPathEncoder
A service to provide utilities needed for event context encoding and decoding to and from (partial) URL paths. This
is used for both component event contexts and page activation contexts.
-
Method Summary
Modifier and TypeMethodDescriptiondecodePath(String path) Inverse ofencodeIntoPath(Object[]); the path is split into strings, and the string are decoded and constructed into anEventContext.encodeIntoPath(Object[] context) Encodes the context values into a path string.encodeIntoPath(EventContext context) Encodes the context into a string.encodeValue(Object value) Encodes a single value via theContextValueEncoderservice, returning the resulting string.
-
Method Details
-
encodeValue
Encodes a single value via theContextValueEncoderservice, returning the resulting string. Even null is encoded, as perURLEncoder.encode(String).- Since:
- 5.2.2
-
encodeIntoPath
Encodes the context values into a path string. Each context value (if non-null) is first value encoded into a string via theContextValueEncoderservice. Those values are then encoded, viaURLEncoder.encode(String)into URL-safe strings. The URL-safe strings are then concatenated together, separated with "/" characters.- Parameters:
context- an array of objects to encode as the context (may be null)- Returns:
- the path-encoded context, or the blank string if the context is empty
-
encodeIntoPath
Encodes the context into a string. Returns the empty string if the context is empty.- Parameters:
context- to encode- Returns:
- encoded values separated by "/" characters, or the empty string
- Since:
- 5.1.0.2
-
decodePath
Inverse ofencodeIntoPath(Object[]); the path is split into strings, and the string are decoded and constructed into anEventContext.- Parameters:
path- to decode, possibly empty or null- Returns:
- corresponding event context
-