Result (ninja-core 3.1.5 API)

java.lang.Object
- ninja.Result

Direct Known Subclasses:: AsyncResult

public class Result
extends java.lang.Object

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`APPLICATION_OCTET_STREAM`
`static java.lang.String`	`APPLICATION_XML`
`static java.lang.String`	`APPLICATON_JSON`
`static java.lang.String`	`APPLICATON_JSONP`
`static java.lang.String`	`CACHE_CONTROL`
`static java.lang.String`	`CACHE_CONTROL_DEFAULT_NOCACHE_VALUE`
`static java.lang.String`	`DATE`
`static java.lang.String`	`EXPIRES`
`static java.lang.String`	`LOCATION`
`static NoHttpBody`	`NO_HTTP_BODY`
`static int`	`SC_200_OK`
`static int`	`SC_204_NO_CONTENT`
`static int`	`SC_300_MULTIPLE_CHOICES`
`static int`	`SC_301_MOVED_PERMANENTLY`
`static int`	`SC_302_FOUND`
`static int`	`SC_303_SEE_OTHER`
`static int`	`SC_304_NOT_MODIFIED`
`static int`	`SC_307_TEMPORARY_REDIRECT`
`static int`	`SC_400_BAD_REQUEST`
`static int`	`SC_403_FORBIDDEN`
`static int`	`SC_404_NOT_FOUND`
`static int`	`SC_500_INTERNAL_SERVER_ERROR`
`static int`	`SC_501_NOT_IMPLEMENTED`
`static java.lang.String`	`TEXT_HTML`
`static java.lang.String`	`TEXT_PLAIN`

Constructor Summary

Constructors
Constructor and Description

Result(int statusCode)
A result.

Constructors
Constructor and Description
`Result(int statusCode)` A result.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`Result`	`addCookie(Cookie cookie)`
`Result`	`addHeader(java.lang.String headerName, java.lang.String headerContent)`
`void`	`charset(java.lang.String charset)`
`Result`	`contentType(java.lang.String contentType)` Sets the content type.
`Result`	`doNotCacheContent()` This function sets Cache-Control: no-cache, no-store Date: (current date) Expires: 1970 => it therefore effectively forces the browser and every proxy in between not to cache content.
`java.lang.String`	`getCharset()`
`java.lang.String`	`getContentType()`
`Cookie`	`getCookie(java.lang.String cookieName)` Returns cookie with that name or null.
`java.util.List<Cookie>`	`getCookies()`
`java.util.Map<java.lang.String,java.lang.String>`	`getHeaders()`
`java.lang.Object`	`getRenderable()`
`int`	`getStatusCode()`
`java.lang.String`	`getTemplate()`
`Result`	`html()` Set the content type of this result to `TEXT_HTML`.
`Result`	`json()` Set the content type of this result to `APPLICATON_JSON`.
`Result`	`jsonp()` Set the content type of this result to `APPLICATON_JSONP`.
`Result`	`redirect(java.lang.String url)` A redirect that uses 303 see other.
`Result`	`redirectTemporary(java.lang.String url)` A redirect that uses 307 see other.
`Result`	`render(java.util.Map.Entry<java.lang.String,java.lang.Object> entry)` Handles two cases: 1) If this.renderable is null a new HashMap is generated and this entry being added to the map.
`Result`	`render(java.util.Map<java.lang.String,java.lang.Object> mapToRender)` Replaces the object being passed by this result to the rendering engine with this map.
`Result`	`render(java.lang.Object object)` This method handles two principal cases: 1) If the this.renderable of this result is null, the object passed is simply set as renderable for this Result 2) If the this.renderable of this result is not null an new map is generated as object to render and both the former renderable and the new object added to the map.
`Result`	`render(Renderable renderable)` Sets this renderable as object to render.
`Result`	`render(java.lang.String key, java.lang.Object value)` Implicitly generates a hashmap as object being rendered and adds this key, value pair.
`Result`	`renderRaw(java.lang.String string)` This method directly renders the String to the output.
`Result`	`setContentType(java.lang.String contentType)` Deprecated.
`Result`	`status(int statusCode)` Set the status of this result.
`Result`	`template(java.lang.String template)` Set the template to render.
`Result`	`unsetCookie(java.lang.String name)`
`Result`	`xml()` Set the content type of this result to `Result#APPLICATON_XML`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SC_200_OK
```
public static int SC_200_OK
```
  - SC_204_NO_CONTENT
```
public static int SC_204_NO_CONTENT
```
  - SC_300_MULTIPLE_CHOICES
```
public static int SC_300_MULTIPLE_CHOICES
```
  - SC_301_MOVED_PERMANENTLY
```
public static int SC_301_MOVED_PERMANENTLY
```
  - SC_302_FOUND
```
public static int SC_302_FOUND
```
  - SC_303_SEE_OTHER
```
public static int SC_303_SEE_OTHER
```
  - SC_304_NOT_MODIFIED
```
public static int SC_304_NOT_MODIFIED
```
  - SC_307_TEMPORARY_REDIRECT
```
public static int SC_307_TEMPORARY_REDIRECT
```
  - SC_400_BAD_REQUEST
```
public static int SC_400_BAD_REQUEST
```
  - SC_403_FORBIDDEN
```
public static int SC_403_FORBIDDEN
```
  - SC_404_NOT_FOUND
```
public static int SC_404_NOT_FOUND
```
  - SC_500_INTERNAL_SERVER_ERROR
```
public static int SC_500_INTERNAL_SERVER_ERROR
```
  - SC_501_NOT_IMPLEMENTED
```
public static int SC_501_NOT_IMPLEMENTED
```
  - TEXT_HTML
```
public static final java.lang.String TEXT_HTML
```
    See Also:
    
    Constant Field Values
  - TEXT_PLAIN
```
public static final java.lang.String TEXT_PLAIN
```
    See Also:
    
    Constant Field Values
  - APPLICATON_JSON
```
public static final java.lang.String APPLICATON_JSON
```
    See Also:
    
    Constant Field Values
  - APPLICATON_JSONP
```
public static final java.lang.String APPLICATON_JSONP
```
    See Also:
    
    Constant Field Values
  - APPLICATION_XML
```
public static final java.lang.String APPLICATION_XML
```
    See Also:
    
    Constant Field Values
  - APPLICATION_OCTET_STREAM
```
public static final java.lang.String APPLICATION_OCTET_STREAM
```
    See Also:
    
    Constant Field Values
  - NO_HTTP_BODY
```
public static final NoHttpBody NO_HTTP_BODY
```
  - LOCATION
```
public static final java.lang.String LOCATION
```
    See Also:
    
    Constant Field Values
  - CACHE_CONTROL
```
public static final java.lang.String CACHE_CONTROL
```
    See Also:
    
    Constant Field Values
  - CACHE_CONTROL_DEFAULT_NOCACHE_VALUE
```
public static final java.lang.String CACHE_CONTROL_DEFAULT_NOCACHE_VALUE
```
    See Also:
    
    Constant Field Values
  - DATE
```
public static final java.lang.String DATE
```
    See Also:
    
    Constant Field Values
  - EXPIRES
```
public static final java.lang.String EXPIRES
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Result
```
public Result(int statusCode)
```
    A result. Sets utf-8 as charset and status code by default. Refer to SC_200_OK, SC_204_NO_CONTENT and so on for some short cuts to predefined results.
    
    Parameters:
    
    statusCode - The status code to set for the result. Shortcuts to the code at: SC_200_OK
- Method Detail
  - getRenderable
```
public java.lang.Object getRenderable()
```
  - render
```
public Result render(java.lang.Object object)
```
    This method handles two principal cases: 1) If the this.renderable of this result is null, the object passed is simply set as renderable for this Result 2) If the this.renderable of this result is not null an new map is generated as object to render and both the former renderable and the new object added to the map. The former object is gets the class name in camelCase as key. If the converted camelCase key of this object already exists an IllegalArgumentException is being thrown.
    
    Parameters:
    
    Object - The object to add (either an arbitrary class or Renderable).
    
    Returns:
    
    Result this result for chaining.
  - render
```
public Result render(java.util.Map<java.lang.String,java.lang.Object> mapToRender)
```
    Replaces the object being passed by this result to the rendering engine with this map. It will overwrite any previously set render(...) calls.
    
    Parameters:
    
    mapToRender - The map being passed to the templating engine.
    
    Returns:
    
    This Result for chaining.
  - render
```
public Result render(java.util.Map.Entry<java.lang.String,java.lang.Object> entry)
```
    Handles two cases: 1) If this.renderable is null a new HashMap is generated and this entry being added to the map. 2) If this.renderable is a Map the entry is added 3) If this.renderable is an object (not a renderable) a Map is generated and both the former object and the new entry are being added. 3) If this.renderable is a Renderable an IllegalArgumentException is thrown. If the entry key already exists in the map of this.renderable an IllegalArgumentException is thrown.
    
    Parameters:
    
    entry - The entry to add.
    
    Returns:
    
    The result for further chaining.
  - render
```
public Result render(Renderable renderable)
```
    Sets this renderable as object to render. Usually this renderable does rendering itself and will not call any templating engine.
    
    Parameters:
    
    renderable - The renderable that will handle everything after returing the result.
    
    Returns:
    
    This result for chaining.
  - render
```
public Result render(java.lang.String key,
                     java.lang.Object value)
```
    Implicitly generates a hashmap as object being rendered and adds this key, value pair. If the object being rendered is already a hashmap it simply adds this key value pair to it.
    
    Parameters:
    
    key - The key to use.
    
    value - The value to use.
    
    Returns:
    
    The Result for chaining.
  - renderRaw
```
public Result renderRaw(java.lang.String string)
```
    This method directly renders the String to the output. It completely bypasses any rendering engine. Thus you can render anything you want. Chaining of resultRaw is NOT supported. Mixing with render() is NOT supported. It is always recommended to implement your own RenderingEngine OR use existing rendering engines. Example: public Result controllerMethod() { String customJson = "{\"user\" : \"[email protected]\"}"; return Results.json().renderRaw(customJson); }
    
    Parameters:
    
    string - The string to render.
    
    Returns:
    
    A result that will render the string directly to the output stream.
  - getContentType
```
public java.lang.String getContentType()
```
  - getCharset
```
public java.lang.String getCharset()
```
    Returns:
    
    Charset of the current result that will be used. Will be "utf-8" by default.
  - charset
```
public void charset(java.lang.String charset)
```
  - setContentType
```
@Deprecated
public Result setContentType(java.lang.String contentType)
```
    Deprecated.
    
    Sets the content type
    
    Parameters:
    
    contentType -
  - contentType
```
public Result contentType(java.lang.String contentType)
```
    Sets the content type. Must not contain any charset WRONG: "text/html; charset=utf8". If you want to set the charset use method charset(String);
    
    Parameters:
    
    contentType - (without encoding) something like "text/html" or "application/json"
  - getHeaders
```
public java.util.Map<java.lang.String,java.lang.String> getHeaders()
```
  - addHeader
```
public Result addHeader(java.lang.String headerName,
                        java.lang.String headerContent)
```
  - getCookie
```
public Cookie getCookie(java.lang.String cookieName)
```
    Returns cookie with that name or null.
    
    Parameters:
    
    cookieName - Name of the cookie
    
    Returns:
    
    The cookie or null if not found.
  - getCookies
```
public java.util.List<Cookie> getCookies()
```
  - addCookie
```
public Result addCookie(Cookie cookie)
```
  - unsetCookie
```
public Result unsetCookie(java.lang.String name)
```
  - getStatusCode
```
public int getStatusCode()
```
  - status
```
public Result status(int statusCode)
```
    Set the status of this result. Refer to SC_200_OK, SC_204_NO_CONTENT and so on for some short cuts to predefined results.
    
    Parameters:
    
    statusCode - The status code. Result (SC_200_OK) provides some helpers.
    
    Returns:
    
    The result you executed the method on for method chaining.
  - getTemplate
```
public java.lang.String getTemplate()
```
  - template
```
public Result template(java.lang.String template)
```
    Set the template to render. For instance template("views/AnotherController/anotherview.ftl.html");
    
    Parameters:
    
    template - The view to render. Eg. views/AnotherController/anotherview.ftl.html
    
    Returns:
    
    The result that you executed the method on for chaining.
  - redirect
```
public Result redirect(java.lang.String url)
```
    A redirect that uses 303 see other.
    
    Parameters:
    
    url - The url used as redirect target.
    
    Returns:
    
    A nicely configured result with status code 303 and the url set as Location header.
  - redirectTemporary
```
public Result redirectTemporary(java.lang.String url)
```
    A redirect that uses 307 see other.
    
    Parameters:
    
    url - The url used as redirect target.
    
    Returns:
    
    A nicely configured result with status code 307 and the url set as Location header.
  - html
```
public Result html()
```
    Set the content type of this result to TEXT_HTML.
    
    Returns:
    
    the same result where you executed this method on. But the content type is now TEXT_HTML.
  - json
```
public Result json()
```
    Set the content type of this result to APPLICATON_JSON.
    
    Returns:
    
    the same result where you executed this method on. But the content type is now APPLICATON_JSON.
  - jsonp
```
public Result jsonp()
```
    Set the content type of this result to APPLICATON_JSONP.
    
    Returns:
    
    the same result where you executed this method on. But the content type is now APPLICATON_JSONP.
  - xml
```
public Result xml()
```
    Set the content type of this result to Result#APPLICATON_XML.
    
    Returns:
    
    the same result where you executed this method on. But the content type is now Result#APPLICATON_XML.
  - doNotCacheContent
```
public Result doNotCacheContent()
```
    This function sets Cache-Control: no-cache, no-store Date: (current date) Expires: 1970 => it therefore effectively forces the browser and every proxy in between not to cache content. See also https://devcenter.heroku.com/articles/increasing-application-performance-with-http-cache-headers
    
    Returns:
    
    this result for chaining.

Class Result

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SC_200_OK

SC_204_NO_CONTENT

SC_300_MULTIPLE_CHOICES

SC_301_MOVED_PERMANENTLY

SC_302_FOUND

SC_303_SEE_OTHER

SC_304_NOT_MODIFIED

SC_307_TEMPORARY_REDIRECT

SC_400_BAD_REQUEST

SC_403_FORBIDDEN

SC_404_NOT_FOUND

SC_500_INTERNAL_SERVER_ERROR

SC_501_NOT_IMPLEMENTED

TEXT_HTML

TEXT_PLAIN

APPLICATON_JSON

APPLICATON_JSONP

APPLICATION_XML

APPLICATION_OCTET_STREAM

NO_HTTP_BODY

LOCATION

CACHE_CONTROL

CACHE_CONTROL_DEFAULT_NOCACHE_VALUE

DATE

EXPIRES

Constructor Detail

Result

Method Detail

getRenderable

render

render

render

render

render

renderRaw

getContentType

getCharset

charset

setContentType

contentType

getHeaders

addHeader

getCookie

getCookies

addCookie

unsetCookie

getStatusCode

status

getTemplate

template

redirect

redirectTemporary

html

json

jsonp

xml

doNotCacheContent