You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@wicket.apache.org by kn...@apache.org on 2007/08/30 16:25:36 UTC
svn commit: r571182 -
/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/ajax/AjaxRequestTarget.java
Author: knopp
Date: Thu Aug 30 07:25:36 2007
New Revision: 571182
URL: http://svn.apache.org/viewvc?rev=571182&view=rev
Log: (empty)
Modified:
wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/ajax/AjaxRequestTarget.java
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/ajax/AjaxRequestTarget.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/ajax/AjaxRequestTarget.java?rev=571182&r1=571181&r2=571182&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/ajax/AjaxRequestTarget.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/ajax/AjaxRequestTarget.java Thu Aug 30 07:25:36 2007
@@ -51,28 +51,26 @@
/**
- * A request target that produces ajax response envelopes used on the client
- * side to update component markup as well as evaluate arbitrary javascript.
+ * A request target that produces ajax response envelopes used on the client side to update
+ * component markup as well as evaluate arbitrary javascript.
* <p>
- * A component whose markup needs to be updated should be added to this target
- * via AjaxRequestTarget#addComponent(Component) method. Its body will be
- * rendered and added to the envelope when the target is processed, and
- * refreshed on the client side when the ajax response is received.
+ * A component whose markup needs to be updated should be added to this target via
+ * AjaxRequestTarget#addComponent(Component) method. Its body will be rendered and added to the
+ * envelope when the target is processed, and refreshed on the client side when the ajax response is
+ * received.
* <p>
- * It is important that the component whose markup needs to be updated contains
- * an id attribute in the generated markup that is equal to the value retrieved
- * from Component#getMarkupId(). This can be accomplished by either setting the
- * id attribute in the html template, or using an attribute modifier that will
- * add the attribute with value Component#getMarkupId() to the tag ( such as
+ * It is important that the component whose markup needs to be updated contains an id attribute in
+ * the generated markup that is equal to the value retrieved from Component#getMarkupId(). This can
+ * be accomplished by either setting the id attribute in the html template, or using an attribute
+ * modifier that will add the attribute with value Component#getMarkupId() to the tag ( such as
* MarkupIdSetter )
* <p>
- * Any javascript that needs to be evaluated on the client side can be added
- * using AjaxRequestTarget#append/prependJavascript(String). For example, this
- * feature can be useful when it is desirable to link component update with some
- * javascript effects.
+ * Any javascript that needs to be evaluated on the client side can be added using
+ * AjaxRequestTarget#append/prependJavascript(String). For example, this feature can be useful when
+ * it is desirable to link component update with some javascript effects.
* <p>
- * The target provides a listener interface {@link IListener} that can be used
- * to add code that responds to various target events by adding listeners via
+ * The target provides a listener interface {@link IListener} that can be used to add code that
+ * responds to various target events by adding listeners via
* {@link #addListener(org.apache.wicket.ajax.AjaxRequestTarget.IListener)}
*
* @since 1.2
@@ -83,8 +81,8 @@
public class AjaxRequestTarget implements IRequestTarget
{
/**
- * An {@link AjaxRequestTarget} listener that can be used to respond to
- * various target-related events
+ * An {@link AjaxRequestTarget} listener that can be used to respond to various target-related
+ * events
*
*/
public static interface IListener
@@ -93,27 +91,24 @@
* Triggered before ajax request target begins its response cycle
*
* @param map
- * read-only map:markupId->component of components already
- * added to the target
+ * read-only map:markupId->component of components already added to the target
* @param target
- * the target itself. Could be used to add components or to
- * append/prepend javascript
+ * the target itself. Could be used to add components or to append/prepend
+ * javascript
*
*/
public void onBeforeRespond(Map map, AjaxRequestTarget target);
/**
- * Triggered after ajax request target is done with its response cycle.
- * At this point only additional javascript can be output to the
- * response using the provided {@link IJavascriptResponse} object
+ * Triggered after ajax request target is done with its response cycle. At this point only
+ * additional javascript can be output to the response using the provided
+ * {@link IJavascriptResponse} object
*
- * NOTE: During this stage of processing any calls to target that
- * manipulate the response (adding components, javascript) will have no
- * effect
+ * NOTE: During this stage of processing any calls to target that manipulate the response
+ * (adding components, javascript) will have no effect
*
* @param map
- * read-only map:markupId->component of components already
- * added to the target
+ * read-only map:markupId->component of components already added to the target
* @param response
* response object that can be used to output javascript
*/
@@ -121,16 +116,15 @@
}
/**
- * An ajax javascript response that allows users to add javascript to be
- * executed on the client side
+ * An ajax javascript response that allows users to add javascript to be executed on the client
+ * side
*
* @author ivaynberg
*/
public static interface IJavascriptResponse
{
/**
- * Adds more javascript to the ajax response that will be executed on
- * the client side
+ * Adds more javascript to the ajax response that will be executed on the client side
*
* @param script
* javascript
@@ -198,8 +192,7 @@
}
/**
- * Resets the response to a clean state so it can be reused to save on
- * garbage.
+ * Resets the response to a clean state so it can be reused to save on garbage.
*/
public void reset()
{
@@ -235,14 +228,14 @@
private final List/* <String> */domReadyJavascripts = new ArrayList();
/**
- * Create a response for component body and javascript that will escape
- * output to make it safe to use inside a CDATA block
+ * Create a response for component body and javascript that will escape output to make it safe
+ * to use inside a CDATA block
*/
private final AjaxResponse encodingBodyResponse;
/**
- * Response for header contributon that will escape output to make it safe
- * to use inside a CDATA block
+ * Response for header contributon that will escape output to make it safe to use inside a CDATA
+ * block
*/
private final AjaxResponse encodingHeaderResponse;
@@ -289,8 +282,8 @@
}
/**
- * Visits all children of the specified parent container and adds them to
- * the target if they are of same type as <code>childCriteria</code>
+ * Visits all children of the specified parent container and adds them to the target if they are
+ * of same type as <code>childCriteria</code>
*
* @param parent
* @param childCriteria
@@ -377,8 +370,7 @@
}
/**
- * Adds javascript that will be evaluated on the client side after
- * components are replaced
+ * Adds javascript that will be evaluated on the client side after components are replaced
*
* @deprecated use appendJavascript(String javascript) instead
* @param javascript
@@ -389,9 +381,8 @@
}
/**
- * Sets the focus in the browser to the given component. The markup id must
- * be set. If the component is null the focus will not be set to any
- * component.
+ * Sets the focus in the browser to the given component. The markup id must be set. If the
+ * component is null the focus will not be set to any component.
*
* @param component
* The component to get the focus or null.
@@ -410,8 +401,7 @@
/**
- * Adds javascript that will be evaluated on the client side after
- * components are replaced
+ * Adds javascript that will be evaluated on the client side after components are replaced
*
* @param javascript
*/
@@ -467,8 +457,7 @@
}
/**
- * Adds javascript that will be evaluated on the client side before
- * components are replaced
+ * Adds javascript that will be evaluated on the client side before components are replaced
*
* @param javascript
*/
@@ -584,9 +573,8 @@
}
/**
- * Processes components added to the target. This involves attaching
- * components, rendering markup into a client side xml envelope, and
- * detaching them
+ * Processes components added to the target. This involves attaching components, rendering
+ * markup into a client side xml envelope, and detaching them
*
* @param response
*/
@@ -700,8 +688,7 @@
}
/**
- * @return name of encoding used to possibly encode the contents of the
- * CDATA blocks
+ * @return name of encoding used to possibly encode the contents of the CDATA blocks
*/
protected String getEncodingName()
{
@@ -716,13 +703,12 @@
protected boolean needsEncoding(String str)
{
/*
- * TODO Post 1.2: Ajax: we can improve this by keeping a buffer of at
- * least 3 characters and checking that buffer so that we can narrow
- * down escaping occuring only for ']]>' sequence, or at least for ]] if ]
- * is the last char in this buffer.
+ * TODO Post 1.2: Ajax: we can improve this by keeping a buffer of at least 3 characters and
+ * checking that buffer so that we can narrow down escaping occuring only for ']]>'
+ * sequence, or at least for ]] if ] is the last char in this buffer.
*
- * but this improvement will only work if we write first and encode
- * later instead of working on fragments sent to write
+ * but this improvement will only work if we write first and encode later instead of working
+ * on fragments sent to write
*/
return str.indexOf(']') >= 0;
@@ -905,9 +891,9 @@
/**
* Returns the header response associated with current AjaxRequestTarget.
*
- * Beware that only renderOnDomReadyJavascript and renderOnLoadJavascript
- * can be called outside the renderHeader(IHeaderResponse response) method.
- * Calls to other render** methods will result in an exception being thrown.
+ * Beware that only renderOnDomReadyJavascript and renderOnLoadJavascript can be called outside
+ * the renderHeader(IHeaderResponse response) method. Calls to other render** methods will
+ * result in an exception being thrown.
*
* @return header response
*/