Package ninja.session
Class FlashScopeImpl
- java.lang.Object
-
- ninja.session.FlashScopeImpl
-
- All Implemented Interfaces:
FlashScope
public class FlashScopeImpl extends Object implements FlashScope
Default FlashScope implementation.
-
-
Constructor Summary
Constructors Constructor Description FlashScopeImpl(NinjaProperties ninjaProperties)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
clearCurrentFlashCookieData()
Clears all "current" flash data.boolean
contains(String key)
Checks if the key exists in the "current" flash data.void
discard()
Discards all "outgoing" flash data but retains all "current" flash data.void
discard(String key)
Discards the key from the "outgoing" flash data but retains it in the "current" flash data.void
error(String value)
Same as callingflash.put("error", "your value");
.String
get(String key)
Gets a value if its in either the "current" or "outgoing" flash data.Map<String,String>
getCurrentFlashCookieData()
Gets all "current" flash data.Map<String,String>
getOutgoingFlashCookieData()
Gets all "outgoing" flash data.void
init(Context context)
Intended for use by implementations only.void
keep()
Copies all "current" flash data into the "outgoing" flash data.void
keep(String key)
Will copy the "current" flash data specified by the key into the "outgoing" flash data.void
now(String key, String value)
Puts the key and value into only the "current" flash data.void
put(String key, Object value)
void
put(String key, String value)
Puts the key and value into both "current" and "outgoing" flash data.boolean
remove(String key)
Removes a value completely from both "current" and "outgoing" flash data.void
save(Context context)
Intended for use by implementations only.void
success(String value)
Same as callingflash.put("success", "your value");
.
-
-
-
Constructor Detail
-
FlashScopeImpl
@Inject public FlashScopeImpl(NinjaProperties ninjaProperties)
-
-
Method Detail
-
init
public void init(Context context)
Description copied from interface:FlashScope
Intended for use by implementations only. Initializes the FlashScope from the context. Ninja will call this when a new request is being handled.- Specified by:
init
in interfaceFlashScope
- Parameters:
context
- The Ninja context
-
save
public void save(Context context)
Description copied from interface:FlashScope
Intended for use by implementations only. Saves the FlashScope to the context. Will write/delete cookies, etc. Ninja will call this when a request will be completed.- Specified by:
save
in interfaceFlashScope
- Parameters:
context
- The Ninja context
-
now
public void now(String key, String value)
Description copied from interface:FlashScope
Puts the key and value into only the "current" flash data. Will NOT be written as a cookie and will only exist for the current request. Accessible via ${flash.key} in your html templating engine.- Specified by:
now
in interfaceFlashScope
- Parameters:
key
- The flash keyvalue
- The i18n key used to retrieve value of that message OR an already translated message (if your template engine supports it)- See Also:
If you need the value for both the current and next request
-
get
public String get(String key)
Description copied from interface:FlashScope
Gets a value if its in either the "current" or "outgoing" flash data.- Specified by:
get
in interfaceFlashScope
- Parameters:
key
- The flash key- Returns:
- The flash value or null if none exists by that key
-
remove
public boolean remove(String key)
Description copied from interface:FlashScope
Removes a value completely from both "current" and "outgoing" flash data.- Specified by:
remove
in interfaceFlashScope
- Parameters:
key
- The flash key- Returns:
- True if removed or false if it didn't exist
-
contains
public boolean contains(String key)
Description copied from interface:FlashScope
Checks if the key exists in the "current" flash data.- Specified by:
contains
in interfaceFlashScope
- Parameters:
key
- The flash key- Returns:
- True if the key exists or false if it doesn't
-
put
public void put(String key, String value)
Description copied from interface:FlashScope
Puts the key and value into both "current" and "outgoing" flash data. Will be written as a cookie and available in the current and next request. If you only need the value in your current request its a good idea to use thenow()
method instead so you can eliminate the possibility of showing unexpected flash messages on the next request :-).- Specified by:
put
in interfaceFlashScope
- Parameters:
key
- The flash keyvalue
- The i18n key used to retrieve value of that message OR an already translated message (if your template engine supports it)- See Also:
If you only need the value in your current request.
-
put
public void put(String key, Object value)
- Specified by:
put
in interfaceFlashScope
-
error
public void error(String value)
Description copied from interface:FlashScope
Same as callingflash.put("error", "your value");
. The value will be added to both "current" and "outgoing" flash data.- Specified by:
error
in interfaceFlashScope
- Parameters:
value
- The i18n key used to retrieve value of that message OR an already translated message (if your template engine supports it)
-
success
public void success(String value)
Description copied from interface:FlashScope
Same as callingflash.put("success", "your value");
. The value will be added to both "current" and "outgoing" flash data.- Specified by:
success
in interfaceFlashScope
- Parameters:
value
- The i18n key used to retrieve value of that message OR an already translated message (if your template engine supports it)
-
discard
public void discard(String key)
Description copied from interface:FlashScope
Discards the key from the "outgoing" flash data but retains it in the "current" flash data.- Specified by:
discard
in interfaceFlashScope
- Parameters:
key
- The flash key- See Also:
To reverse this operation and keep the key as part of the "outgoing" flash data.
-
discard
public void discard()
Description copied from interface:FlashScope
Discards all "outgoing" flash data but retains all "current" flash data.- Specified by:
discard
in interfaceFlashScope
- See Also:
To reverse this operation and keep all keys as part of the "outgoing" flash data.
-
keep
public void keep(String key)
Description copied from interface:FlashScope
Will copy the "current" flash data specified by the key into the "outgoing" flash data.- Specified by:
keep
in interfaceFlashScope
- Parameters:
key
- The flash key
-
keep
public void keep()
Description copied from interface:FlashScope
Copies all "current" flash data into the "outgoing" flash data.- Specified by:
keep
in interfaceFlashScope
-
clearCurrentFlashCookieData
public void clearCurrentFlashCookieData()
Description copied from interface:FlashScope
Clears all "current" flash data. If you need to ensure all "current" and "outgoing" flash data is deleted then call this as well as discard().- Specified by:
clearCurrentFlashCookieData
in interfaceFlashScope
-
getCurrentFlashCookieData
public Map<String,String> getCurrentFlashCookieData()
Description copied from interface:FlashScope
Gets all "current" flash data.- Specified by:
getCurrentFlashCookieData
in interfaceFlashScope
- Returns:
- All current flash data
-
getOutgoingFlashCookieData
public Map<String,String> getOutgoingFlashCookieData()
Description copied from interface:FlashScope
Gets all "outgoing" flash data.- Specified by:
getOutgoingFlashCookieData
in interfaceFlashScope
- Returns:
- All outgoing flash data
-
-