Package com.aspectran.core.activity
Interface Translet
-
- All Superinterfaces:
BeanRegistry
,MessageSource
- All Known Implementing Classes:
AbstractTranslet
,CoreTranslet
public interface Translet extends BeanRegistry, MessageSource
The Interface Translet.Created: 2008. 7. 5. AM 12:35:44
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
acceptsProfiles(java.lang.String... profiles)
Return whether the given profile is active.void
clearRaisedException()
void
dispatch(DispatchResponseRule dispatchResponseRule)
Dispatch to other resources as the given rule.void
dispatch(java.lang.String name)
Dispatch to other resources as the given name.void
dispatch(java.lang.String name, java.lang.String dispatcherName)
Dispatch to other resources as the given name.void
extractParameters(java.util.Map<java.lang.String,java.lang.Object> targetParameters)
Extracts all the parameters and fills in the specified map.void
forward(ForwardResponseRule forwardResponseRule)
Forward according to a given rule.void
forward(java.lang.String transletName)
Forward to the specified translet immediately.ActivityDataMap
getActivityDataMap()
Returns an Activity Data Map containing the activity result data.<T> T
getAfterAdviceResult(java.lang.String aspectId)
Gets the after advice result.java.util.Map<java.lang.String,java.lang.Object>
getAllParameters()
Return an mutable Map of the request parameters, with parameter names as map keys and parameter values as map values.<T> T
getApplicationAdaptee()
Returns the adaptee object to provide application information.ApplicationAdapter
getApplicationAdapter()
Gets the application adapter.<T> T
getAroundAdviceResult(java.lang.String aspectId)
Gets the around advice result.<T> T
getAspectAdviceBean(java.lang.String aspectId)
Gets the aspect advice bean.<T> T
getAttribute(java.lang.String name)
Returns the value of the named attribute as a given type, ornull
if no attribute of the given name exists.java.util.Collection<java.lang.String>
getAttributeNames()
Returns aCollection
containing the names of the attributes available to this request.<T> T
getBeforeAdviceResult(java.lang.String aspectId)
Gets the before advice result.Response
getDeclaredResponse()
Returns the originally declared response.java.lang.String
getDescription()
Returns a description of thisTranslet
.Environment
getEnvironment()
Returns the environment of the current activity context.FileParameter
getFileParameter(java.lang.String name)
Returns aFileParameter
object as a given activity's request parameter name, ornull
if the parameter does not exist.java.util.Collection<java.lang.String>
getFileParameterNames()
Returns aCollection
ofString
objects containing the names of the file parameters contained in this request.FileParameter[]
getFileParameterValues(java.lang.String name)
Returns an array ofFileParameter
objects containing all of the values the given activity's request parameter has, ornull
if the parameter does not exist.<T> T
getFinallyAdviceResult(java.lang.String aspectId)
Gets the finally advice result.java.lang.String
getMessage(java.lang.String code, java.lang.Object[] args)
Try to resolve the message.java.lang.String
getMessage(java.lang.String code, java.lang.Object[] args, java.lang.String defaultMessage)
Try to resolve the message.java.lang.String
getParameter(java.lang.String name)
Returns the value of an activity's request parameter as aString
, ornull
if the parameter does not exist.java.util.Collection<java.lang.String>
getParameterNames()
Returns aCollection
ofString
objects containing the names of the parameters contained in this request.java.lang.String[]
getParameterValues(java.lang.String name)
Returns an array ofString
objects containing all of the values the given activity's request parameter has, ornull
if the parameter does not exist.ProcessResult
getProcessResult()
Returns the process result.java.lang.Object
getProcessResult(java.lang.String actionId)
Returns a action result for the specified action id from the process result, ornull
if the action does not exist.<T> T
getProperty(java.lang.String name)
Returns the value of the property on environment.java.lang.Throwable
getRaisedException()
Returns the raised exception instance.<T> T
getRequestAdaptee()
Returns the adaptee object to provide request information.RequestAdapter
getRequestAdapter()
Gets the request adapter.java.lang.String
getRequestEncoding()
Returns the request encoding.MethodType
getRequestMethod()
Gets the request http method.java.lang.String
getRequestName()
Returns the request name for thisTranslet
.<T> T
getResponseAdaptee()
Returns the adaptee object to provide response information.ResponseAdapter
getResponseAdapter()
Gets the response adapter.java.lang.String
getResponseEncoding()
Returns the response encoding.java.lang.Throwable
getRootCauseOfRaisedException()
Returns the innermost one of the chained (wrapped) exceptions.<T> T
getSessionAdaptee()
Returns the adaptee object to provide session information.SessionAdapter
getSessionAdapter()
Gets the session adapter.<T> T
getSetting(java.lang.String settingName)
Gets the setting value in the translet scope.boolean
hasPathVariable()
boolean
isExceptionRaised()
Returns whether the exception was thrown.void
redirect(RedirectResponseRule redirectResponseRule)
Redirect a client according to the given rule.void
redirect(java.lang.String path)
Redirect a client to a new target resource.void
redirect(java.lang.String path, java.util.Map<java.lang.String,java.lang.String> parameters)
Redirect to the other target resource.void
removeAttribute(java.lang.String name)
Removes an attribute from this request.void
removeFileParameter(java.lang.String name)
Removes the file parameter with the specified name.void
response()
Respond immediately, and the remaining jobs will be canceled.void
response(Response response)
Respond immediately, and the remaining jobs will be canceled.void
setAttribute(java.lang.String name, java.lang.Object value)
Stores an attribute in this request.void
setFileParameter(java.lang.String name, FileParameter fileParameter)
Sets theFileParameter
object to the file parameter with the given name.void
setFileParameter(java.lang.String name, FileParameter[] fileParameters)
Sets the value to the file parameter with the given name.void
setParameter(java.lang.String name, java.lang.String value)
Sets the value to the parameter with the given name.void
setParameter(java.lang.String name, java.lang.String[] values)
Sets the value to the parameter with the given name.void
setProcessResult(ProcessResult processResult)
Sets the process result.ProcessResult
touchProcessResult()
Returns the ProcessResult.ProcessResult
touchProcessResult(java.lang.String contentsName)
Returns the process result with the contents name.ProcessResult
touchProcessResult(java.lang.String contentsName, int initialCapacity)
Returns the process result with the contents name.void
transform(TransformRule transformRule)
Transformation according to a given rule, and transmits this response.-
Methods inherited from interface com.aspectran.core.component.bean.BeanRegistry
containsBean, containsBean, getBean, getBean, getBean, getBean, getConfigBean
-
Methods inherited from interface com.aspectran.core.support.i18n.message.MessageSource
getMessage, getMessage
-
-
-
-
Method Detail
-
getRequestName
java.lang.String getRequestName()
Returns the request name for thisTranslet
.- Returns:
- the request name
-
getRequestMethod
MethodType getRequestMethod()
Gets the request http method.- Returns:
- the request method
-
getDescription
java.lang.String getDescription()
Returns a description of thisTranslet
.- Returns:
- a description of this
Translet
-
getEnvironment
Environment getEnvironment()
Returns the environment of the current activity context.- Returns:
- the environment
-
getApplicationAdapter
ApplicationAdapter getApplicationAdapter()
Gets the application adapter.- Returns:
- the application adapter
-
getSessionAdapter
SessionAdapter getSessionAdapter()
Gets the session adapter.- Returns:
- the session adapter
-
getRequestAdapter
RequestAdapter getRequestAdapter()
Gets the request adapter.- Returns:
- the request adapter
-
getResponseAdapter
ResponseAdapter getResponseAdapter()
Gets the response adapter.- Returns:
- the response adapter
-
getApplicationAdaptee
<T> T getApplicationAdaptee()
Returns the adaptee object to provide application information.- Type Parameters:
T
- the type of the application adaptee- Returns:
- the application adaptee object
-
getSessionAdaptee
<T> T getSessionAdaptee()
Returns the adaptee object to provide session information.- Type Parameters:
T
- the type of the session adaptee- Returns:
- the session adaptee object
-
getRequestAdaptee
<T> T getRequestAdaptee()
Returns the adaptee object to provide request information.- Type Parameters:
T
- the type of the request adaptee- Returns:
- the request adaptee object
-
getResponseAdaptee
<T> T getResponseAdaptee()
Returns the adaptee object to provide response information.- Type Parameters:
T
- the type of the response adaptee- Returns:
- the response adaptee object
-
getRequestEncoding
java.lang.String getRequestEncoding()
Returns the request encoding.- Returns:
- the request encoding
-
getResponseEncoding
java.lang.String getResponseEncoding()
Returns the response encoding.- Returns:
- the response encoding
-
getProcessResult
ProcessResult getProcessResult()
Returns the process result.- Returns:
- the process result
-
getProcessResult
java.lang.Object getProcessResult(java.lang.String actionId)
Returns a action result for the specified action id from the process result, ornull
if the action does not exist.- Parameters:
actionId
- the specified action id- Returns:
- the action result
-
setProcessResult
void setProcessResult(ProcessResult processResult)
Sets the process result.- Parameters:
processResult
- the new process result
-
touchProcessResult
ProcessResult touchProcessResult()
Returns the ProcessResult. If not yet instantiated then create a new one.- Returns:
- the process result
-
touchProcessResult
ProcessResult touchProcessResult(java.lang.String contentsName)
Returns the process result with the contents name. If not yet instantiated then create a new one.- Parameters:
contentsName
- the contents name- Returns:
- the process result
-
touchProcessResult
ProcessResult touchProcessResult(java.lang.String contentsName, int initialCapacity)
Returns the process result with the contents name. If not yet instantiated then create a new one.- Parameters:
contentsName
- the contents nameinitialCapacity
- the initial capacity of the process result- Returns:
- the process result
-
getActivityDataMap
ActivityDataMap getActivityDataMap()
Returns an Activity Data Map containing the activity result data.- Returns:
- the activity data map
-
getSetting
<T> T getSetting(java.lang.String settingName)
Gets the setting value in the translet scope.- Type Parameters:
T
- the type of the value- Parameters:
settingName
- the setting name- Returns:
- the setting value
-
getProperty
<T> T getProperty(java.lang.String name)
Returns the value of the property on environment.- Type Parameters:
T
- the type of the value- Parameters:
name
- the given property name- Returns:
- the value of the property on environment
-
getParameter
java.lang.String getParameter(java.lang.String name)
Returns the value of an activity's request parameter as aString
, ornull
if the parameter does not exist.- Parameters:
name
- aString
specifying the name of the parameter- Returns:
- a
String
representing the single value of the parameter - See Also:
getParameterValues(java.lang.String)
-
getParameterValues
java.lang.String[] getParameterValues(java.lang.String name)
Returns an array ofString
objects containing all of the values the given activity's request parameter has, ornull
if the parameter does not exist.- Parameters:
name
- aString
specifying the name of the parameter- Returns:
- an array of
String
objects containing the parameter's values - See Also:
getParameter(java.lang.String)
-
getParameterNames
java.util.Collection<java.lang.String> getParameterNames()
Returns aCollection
ofString
objects containing the names of the parameters contained in this request. If the request has no parameters, the method returns an emptyCollection
.- Returns:
- an
Collection
ofString
objects, eachString
containing the name of a request parameter; or an emptyCollection
if the request has no parameters
-
setParameter
void setParameter(java.lang.String name, java.lang.String value)
Sets the value to the parameter with the given name.- Parameters:
name
- aString
specifying the name of the parametervalue
- aString
representing the single value of the parameter- See Also:
setParameter(String, String[])
-
setParameter
void setParameter(java.lang.String name, java.lang.String[] values)
Sets the value to the parameter with the given name.- Parameters:
name
- aString
specifying the name of the parametervalues
- an array ofString
objects containing the parameter's values- See Also:
setParameter(java.lang.String, java.lang.String)
-
getAllParameters
java.util.Map<java.lang.String,java.lang.Object> getAllParameters()
Return an mutable Map of the request parameters, with parameter names as map keys and parameter values as map values. If the parameter value type is theString
then map value will be of typeString
. If the parameter value type is theString
array then map value will be of typeString
array.- Returns:
- the mutable parameter map
- Since:
- 1.4.0
-
extractParameters
void extractParameters(java.util.Map<java.lang.String,java.lang.Object> targetParameters)
Extracts all the parameters and fills in the specified map.- Parameters:
targetParameters
- the target parameter map to be filled- Since:
- 2.0.0
-
getFileParameter
FileParameter getFileParameter(java.lang.String name)
Returns aFileParameter
object as a given activity's request parameter name, ornull
if the parameter does not exist.- Parameters:
name
- aString
specifying the name of the file parameter- Returns:
- a
FileParameter
representing the single value of the parameter - See Also:
getFileParameterValues(java.lang.String)
-
getFileParameterValues
FileParameter[] getFileParameterValues(java.lang.String name)
Returns an array ofFileParameter
objects containing all of the values the given activity's request parameter has, ornull
if the parameter does not exist.- Parameters:
name
- aString
specifying the name of the file parameter- Returns:
- an array of
FileParameter
objects containing the parameter's values - See Also:
getFileParameter(java.lang.String)
-
getFileParameterNames
java.util.Collection<java.lang.String> getFileParameterNames()
Returns aCollection
ofString
objects containing the names of the file parameters contained in this request. If the request has no parameters, the method returns an emptyCollection
.- Returns:
- an
Collection
ofString
objects, eachString
containing the name of a file parameter; or an emptyCollection
if the request has no file parameters
-
setFileParameter
void setFileParameter(java.lang.String name, FileParameter fileParameter)
Sets theFileParameter
object to the file parameter with the given name.- Parameters:
name
- aString
specifying the name of the file parameterfileParameter
- aFileParameter
representing the single value of the parameter- See Also:
setFileParameter(String, FileParameter[])
-
setFileParameter
void setFileParameter(java.lang.String name, FileParameter[] fileParameters)
Sets the value to the file parameter with the given name.- Parameters:
name
- aString
specifying the name of the file parameterfileParameters
- an array ofFileParameter
objects containing the file parameter's values- See Also:
setFileParameter(java.lang.String, com.aspectran.core.activity.request.parameter.FileParameter)
-
removeFileParameter
void removeFileParameter(java.lang.String name)
Removes the file parameter with the specified name.- Parameters:
name
- aString
specifying the name of the file parameter
-
getAttribute
<T> T getAttribute(java.lang.String name)
Returns the value of the named attribute as a given type, ornull
if no attribute of the given name exists.- Type Parameters:
T
- the generic type- Parameters:
name
- aString
specifying the name of the attribute- Returns:
- an
Object
containing the value of the attribute, ornull
if the attribute does not exist
-
setAttribute
void setAttribute(java.lang.String name, java.lang.Object value)
Stores an attribute in this request.- Parameters:
name
- specifying the name of the attributevalue
- theObject
to be stored
-
getAttributeNames
java.util.Collection<java.lang.String> getAttributeNames()
Returns aCollection
containing the names of the attributes available to this request. This method returns an emptyCollection
if the request has no attributes available to it.- Returns:
- the attribute names
-
removeAttribute
void removeAttribute(java.lang.String name)
Removes an attribute from this request.- Parameters:
name
- aString
specifying the name of the attribute to remove
-
getDeclaredResponse
Response getDeclaredResponse()
Returns the originally declared response.- Returns:
- the declared response
- Since:
- 5.2.0
-
response
void response()
Respond immediately, and the remaining jobs will be canceled.
-
response
void response(Response response)
Respond immediately, and the remaining jobs will be canceled.- Parameters:
response
- the response
-
transform
void transform(TransformRule transformRule)
Transformation according to a given rule, and transmits this response.- Parameters:
transformRule
- the transformation rule
-
dispatch
void dispatch(java.lang.String name)
Dispatch to other resources as the given name.- Parameters:
name
- the dispatch name
-
dispatch
void dispatch(java.lang.String name, java.lang.String dispatcherName)
Dispatch to other resources as the given name.- Parameters:
name
- the dispatch namedispatcherName
- the id or class name of the view dispatcher bean
-
dispatch
void dispatch(DispatchResponseRule dispatchResponseRule)
Dispatch to other resources as the given rule.- Parameters:
dispatchResponseRule
- the dispatch response rule
-
forward
void forward(java.lang.String transletName)
Forward to the specified translet immediately.- Parameters:
transletName
- the translet name of the target to be forwarded
-
forward
void forward(ForwardResponseRule forwardResponseRule)
Forward according to a given rule.- Parameters:
forwardResponseRule
- the forward response rule
-
redirect
void redirect(java.lang.String path)
Redirect a client to a new target resource. If an intended redirect response rule exists, that may be used.- Parameters:
path
- the redirect path
-
redirect
void redirect(java.lang.String path, java.util.Map<java.lang.String,java.lang.String> parameters)
Redirect to the other target resource.- Parameters:
path
- the redirect pathparameters
- the parameters
-
redirect
void redirect(RedirectResponseRule redirectResponseRule)
Redirect a client according to the given rule.- Parameters:
redirectResponseRule
- the redirect response rule
-
isExceptionRaised
boolean isExceptionRaised()
Returns whether the exception was thrown.- Returns:
- true, if is exception raised
-
getRaisedException
java.lang.Throwable getRaisedException()
Returns the raised exception instance.- Returns:
- the raised exception instance
-
getRootCauseOfRaisedException
java.lang.Throwable getRootCauseOfRaisedException()
Returns the innermost one of the chained (wrapped) exceptions.- Returns:
- the innermost one of the chained (wrapped) exceptions
-
clearRaisedException
void clearRaisedException()
-
acceptsProfiles
boolean acceptsProfiles(java.lang.String... profiles)
Return whether the given profile is active. If active profiles are empty whether the profile should be active by default.- Parameters:
profiles
- the profiles- Returns:
true
if profile is active, otherwisefalse
-
getAspectAdviceBean
<T> T getAspectAdviceBean(java.lang.String aspectId)
Gets the aspect advice bean.- Type Parameters:
T
- the generic type- Parameters:
aspectId
- the aspect id- Returns:
- the aspect advice bean
-
getBeforeAdviceResult
<T> T getBeforeAdviceResult(java.lang.String aspectId)
Gets the before advice result.- Type Parameters:
T
- the generic type- Parameters:
aspectId
- the aspect id- Returns:
- the before advice result
-
getAfterAdviceResult
<T> T getAfterAdviceResult(java.lang.String aspectId)
Gets the after advice result.- Type Parameters:
T
- the generic type- Parameters:
aspectId
- the aspect id- Returns:
- the after advice result
-
getAroundAdviceResult
<T> T getAroundAdviceResult(java.lang.String aspectId)
Gets the around advice result.- Type Parameters:
T
- the generic type- Parameters:
aspectId
- the aspect id- Returns:
- the around advice result
-
getFinallyAdviceResult
<T> T getFinallyAdviceResult(java.lang.String aspectId)
Gets the finally advice result.- Type Parameters:
T
- the generic type- Parameters:
aspectId
- the aspect id- Returns:
- the finally advice result
-
hasPathVariable
boolean hasPathVariable()
-
getMessage
java.lang.String getMessage(java.lang.String code, java.lang.Object[] args, java.lang.String defaultMessage)
Try to resolve the message. Return default message if no message was found.- Parameters:
code
- the code to lookup up, such as 'calculator.noRateSet'. Users of this class are encouraged to base message names on the relevant fully qualified class name, thus avoiding conflict and ensuring maximum clarity.args
- array of arguments that will be filled in for params within the message (params look like "{0}", "{1,date}", "{2,time}" within a message), ornull
if none.defaultMessage
- String to return if the lookup fails- Returns:
- the resolved message if the lookup was successful; otherwise the default message passed as a parameter
- See Also:
MessageFormat
-
getMessage
java.lang.String getMessage(java.lang.String code, java.lang.Object[] args) throws NoSuchMessageException
Try to resolve the message. Treat as an error if the message can't be found.- Parameters:
code
- the code to lookup up, such as 'calculator.noRateSet'args
- Array of arguments that will be filled in for params within the message (params look like "{0}", "{1,date}", "{2,time}" within a message), ornull
if none.- Returns:
- the resolved message
- Throws:
NoSuchMessageException
- if the message wasn't found- See Also:
MessageFormat
-
-