Prepends the handler to the Json Handlers.
Prepends the handler to the Json Handlers. Should only be used during instantiation
-- the PartialFunction that can handle a JSON request
Convert a Seq[Node] (the superclass of NodeSeq) to a RenderOut.
Convert a Seq[Node] (the superclass of NodeSeq) to a RenderOut. The render method returns a RenderOut. This method implicitly (in Scala) or explicitly (in Java) will convert a NodeSeq to a RenderOut. This is helpful if you return a NodeSeq from your render method.
Ask another CometActor a question.
Ask another CometActor a question. That other CometActor will take over the screen real estate until the question is answered.
Set this method to true to have the Json call code included in the Comet output
Set this method to true to have the Json call code included in the Comet output
A helper for binding which uses the defaultHtml property and the default prefix.
A helper for binding which uses the defaultHtml property and the default prefix.
A helper for binding which uses the defaultHtml property.
A helper for binding which uses the defaultHtml property.
Creates the span element acting as the real estate for comet rendering.
Creates the span element acting as the real estate for comet rendering.
By default, we do not cache the value of fixedRender.
By default, we do not cache the value of fixedRender. If it's expensive to recompute it each time there's a conversion of something to a RenderOut, override this method if you want to cache fixedRender.
Calculate fixedRender and capture the postpage javascript
Calculate fixedRender and capture the postpage javascript
Comet Actors live outside the HTTP request/response cycle.
Comet Actors live outside the HTTP request/response cycle. However, it may be useful to know what Request led to the creation of the CometActor. You can override this method and capture the initial Req object. Note that keeping a reference to the Req may lead to memory retention issues if the Req contains large message bodies, etc. It's optimal to capture the path or capture any request parameters that you care about rather the keeping the whole Req reference.
Clear the common dependencies for Wiring.
Clear the common dependencies for Wiring. This method will clearPostPageJavaScriptForThisPage() and unregisterFromAllDependencies(). The combination will result in a clean slate for Wiring during a redraw. You can change the behavior of the wiring dependency management by overriding this method
The locale for the session that created the CometActor
The locale for the session that created the CometActor
Return the list of ListenerIds of all long poll agents that are waiting for this CometActor to change its state.
Return the list of ListenerIds of all long poll agents that are waiting for this CometActor to change its state. This method is useful for detecting presence.
Override in sub-class to customise timeout for AJAX-requests to the comet-component for the specific comet
Override in sub-class to customise timeout for AJAX-requests to the comet-component for the specific comet
This is to react to comet-requests timing out.
This is to react to comet-requests timing out.
When the timeout specified in LiftRules#cometProcessingTimeout
occurs one may override
this to send a message to the user informing of the timeout.
Do NOT manipulate actor-state here. If you want to manipulate state, send the actor a new message.
Typical example would be:
override def cometTimeoutHandler(): JsCmd = { Alert("Timeout processing comet-request, timeout is: " + cometProcessingTimeout + "ms") }
Override in sub-class to customise timeout for the render()-method for the specific comet
Override in sub-class to customise timeout for the render()-method for the specific comet
This is to react to comet-actors timing out while initial rendering, calls to render().
This is to react to comet-actors timing out while initial rendering, calls to render().
When the timeout specified in LiftRules#cometRenderTimeout
occurs one may override
this to customise the output.
Do NOT manipulate actor-state here. If you want to manipulate state, send the actor a new message.
Typical example would be:
override def renderTimeoutHandler(): Box[NodeSeq] = { Full(<div>Comet {this.getClass} timed out, timeout is {cometRenderTimeout}ms</div>) }
Compose the Message Handler function.
Compose the Message Handler function. By default, composes highPriority orElse mediumPriority orElse internalHandler orElse lowPriority orElse internalHandler. But you can change how the handler works if doing stuff in highPriority, mediumPriority and lowPriority is not enough.
The template that was passed to this component during comet initializations
The template that was passed to this component during comet initializations
Set to 'true' if we should run "render" on every page load
Set to 'true' if we should run "render" on every page load
Set this method to true if you want to avoid caching the rendering.
Set this method to true if you want to avoid caching the rendering. This trades space for time.
Similar with S.
Similar with S.error
Similar with S.
Similar with S.error
Similar with S.
Similar with S.error
Similar with S.
Similar with S.error
A part of the CometActor's screen real estate that is not updated by default with reRender().
A part of the CometActor's screen real estate that is not updated by default with reRender(). This block of HTML is useful for the editor part of a Comet-based control where the data is JSON and updated with partialUpdates.
Handle messages sent to this Actor before the
Handle messages sent to this Actor before the
It's seriously suboptimal to override this method.
It's seriously suboptimal to override this method. Instead use localSetup()
The JavaScript call that you use to send the data to the server.
The JavaScript call that you use to send the data to the server. For example: <button onclick={jsonSend("Hello", JsRaw("Dude".encJs))}>Click</button>
The call that packages up the JSON and tosses it to the server.
The call that packages up the JSON and tosses it to the server. If you set autoIncludeJsonCode to true, then this will be included in the stuff sent to the server.
The last "when" sent from the listener
The last "when" sent from the listener
the last when sent from the listener
The lifespan of this component.
The lifespan of this component. By default CometActors will last for the entire session that they were created in, even if the CometActor is not currently visible. You can set the lifespan of the CometActor. If the CometActor isn't visible on any page for some period after its lifespan the CometActor will be shut down.
This method will be called when there's a change in the long poll listeners.
This method will be called when there's a change in the long poll listeners. The method does nothing, but allows you to get a granular sense of how many browsers care about this CometActor. Note that this method should not block for any material time and if there's any processing to do, use Scheduler.schedule or send a message to this CometActor. Do not change the Actor's state from this method.
This method will be called after the Actor has started.
This method will be called after the Actor has started. Do any setup here. DO NOT do initialization in the constructor or in initCometActor... do it here.
This method will be called as part of the shut-down of the actor.
This method will be called as part of the shut-down of the actor. Release any resources here.
By default, Lift deals with managing wiring dependencies.
By default, Lift deals with managing wiring dependencies. This means on each full render (a full render will happen on reRender() or on a page load if there have been partial updates.) You may want to manually deal with wiring dependencies. If you do, override this method and return true
The optional name of this CometActors
The optional name of this CometActors
A helpful implicit conversion that takes a NodeSeq => NodeSeq (for example a CssSel) and converts it to a Box[NodeSeq] by applying the function to defaultHtml
A helpful implicit conversion that takes a NodeSeq => NodeSeq (for example a CssSel) and converts it to a Box[NodeSeq] by applying the function to defaultHtml
Similar with S.
Similar with S.notice
Similar with S.
Similar with S.notice
Similar with S.
Similar with S.notice
Similar with S.
Similar with S.notice
Convert a NodeSeq => NodeSeq to a RenderOut.
Convert a NodeSeq => NodeSeq to a RenderOut. The render method returns a RenderOut. This method implicitly (in Scala) or explicitly (in Java) will convert a NodeSeq => NodeSeq to a RenderOut. This is helpful if you use Lift's CSS Selector Transforms to define rendering.
If there's actor-specific JSON behavior on failure to make the JSON call, include the JavaScript here.
If there's actor-specific JSON behavior on failure to make the JSON call, include the JavaScript here.
Perform a partial update of the comet component based on the JsCmd.
Perform a partial update of the comet component based on the JsCmd. This means that the JsCmd will be sent to all of the currently listening browser tabs. This is the preferred method over reRender to update the component
Poke the CometActor and cause it to do a partial update Noop which will have the effect of causing the component to redisplay any Wiring elements on the component.
Poke the CometActor and cause it to do a partial update Noop which will have the effect of causing the component to redisplay any Wiring elements on the component. This method is Actor-safe and may be called from any thread, not just the Actor's message handler thread.
If the predicate cell changes, the Dependent will be notified
If the predicate cell changes, the Dependent will be notified
Cause the entire component to be reRendered and pushed out to any listeners.
Cause the entire component to be reRendered and pushed out to any listeners. This method will cause the entire component to be rendered which can result in a huge blob of JavaScript to be sent to the client. It's a much better practice to use partialUpdate for non-trivial CometActor components.
Cause the entire component to be reRendered and pushed out to any listeners.
Cause the entire component to be reRendered and pushed out to any listeners. This method will cause the entire component to be rendered which can result in a huge blob of JavaScript to be sent to the client. It's a much better practice to use partialUpdate for non-trivial CometActor components.
-- Should the fixed part of the CometActor be rendered.
Override this method to deal with JSON sent from the browser via the sendJson function.
Override this method to deal with JSON sent from the browser via the sendJson function. This is based on the Lift JSON package rather than the handleJson stuff based on the older util.JsonParser. This is the preferred mechanism. If you use the jsonSend call, you will get a JObject(JField("command", cmd), JField("param", params))
The Render method
The Render method
Get the current render clock for the CometActor
How to report an error that occurs during message dispatch
How to report an error that occurs during message dispatch
Is the CometActor running?
Is the CometActor running?
Is this CometActor going to capture the initial Req object? If yes, override this method and return true and override captureInitialReq to capture the Req.
Is this CometActor going to capture the initial Req object? If yes, override this method and return true and override captureInitialReq to capture the Req. Why have to explicitly ask for the Req? In order to send Req instances across threads, the Req objects must be snapshotted which is the process of reading the POST or PUT body from the HTTP request stream. We don't want to do this unless we have to, so by default the Req is not snapshotted/sent. But if you want it, you can have it.
If there's some ThreadLocal variable that needs to be set up before processing the state deltas, set it up here.
If there's some ThreadLocal variable that needs to be set up before processing the state deltas, set it up here.
The current state objects
The current state objects
The optional type of this CometActor
The optional type of this CometActor
Similar with S.
Similar with S.warning
Similar with S.
Similar with S.warning
Similar with S.
Similar with S.warning
Similar with S.
Similar with S.warning