Cleans up MD
Project: http://git-wip-us.apache.org/repos/asf/struts-site/repo Commit: http://git-wip-us.apache.org/repos/asf/struts-site/commit/c9f61f03 Tree: http://git-wip-us.apache.org/repos/asf/struts-site/tree/c9f61f03 Diff: http://git-wip-us.apache.org/repos/asf/struts-site/diff/c9f61f03 Branch: refs/heads/master Commit: c9f61f03d7f229d58452b05b9654ecb4532116c6 Parents: 5cc381e Author: Lukasz Lenart <[email protected]> Authored: Wed Jun 28 17:49:04 2017 +0200 Committer: Lukasz Lenart <[email protected]> Committed: Wed Jun 28 17:49:04 2017 +0200 ---------------------------------------------------------------------- source/core-developers/ajax.md | 147 ++++++++++++++++++------------------ 1 file changed, 72 insertions(+), 75 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/struts-site/blob/c9f61f03/source/core-developers/ajax.md ---------------------------------------------------------------------- diff --git a/source/core-developers/ajax.md b/source/core-developers/ajax.md index b8a39be..9deceba 100644 --- a/source/core-developers/ajax.md +++ b/source/core-developers/ajax.md @@ -5,36 +5,39 @@ title: AJAX # AJAX -AJAX is an acronym for Asynchronous JavaScript and XML\. Essentially, a JavaScript can make a HTTP request and update portions of a page directly, without going through a conventional POST or GET and refreshing the entire page\. Better yet, a page can contain several JavaScripts making simultaneous (asynchronous) requests\. +AJAX is an acronym for Asynchronous JavaScript and XML. Essentially, a JavaScript can make a HTTP request and update +portions of a page directly, without going through a conventional POST or GET and refreshing the entire page. +Better yet, a page can contain several JavaScripts making simultaneous (asynchronous) requests. -The key point is that when a script makes an "Ajax request" (XHR), the server doesn't know it came from a script, and handles it like any other request\. One reason Ajax is so successful is that it works just fine with existing server technologies, including Struts\. +The key point is that when a script makes an "Ajax request" (XHR), the server doesn't know it came from a script, +and handles it like any other request. One reason Ajax is so successful is that it works just fine with existing server +technologies, including Struts. -It's not the Ajax request that is different, but the Ajax response\. Instead of returning an entire page for the browser to display (or redisplay), an Ajax response will just return a portion of a page\. The response can take the form of XML, or HTML, or plain text, another script, or whatever else the calling script may want\. +It's not the Ajax request that is different, but the Ajax response. Instead of returning an entire page for the browser +to display (or redisplay), an Ajax response will just return a portion of a page. The response can take the form of XML, +or HTML, or plain text, another script, or whatever else the calling script may want. -Both Struts 1 and Struts 2 can return any type of response\. We are not limited to forwarding to a server page\. In Struts 1, you can just do something like: +Both Struts 1 and Struts 2 can return any type of response. We are not limited to forwarding to a server page. +In Struts 1, you can just do something like: - -~~~~~~~ +```java response.setContentType("text/html"); PrintWriter out = response.getWriter(); out.println("Hello World! This is an AJAX response from a Struts Action."); out.flush(); return null; +``` -~~~~~~~ - -In Struts 2, we can do the same thing with a Stream result\. - +In Struts 2, we can do the same thing with a Stream result. -| Using a Struts 2 plugin (e\.g\., _JSON plugin_ , jQuery plugin, etc\.) is, in general, preferred to writing the response directly from within an action\. See sections following this for further details\. +> Using a Struts 2 plugin (e.g., _JSON plugin_ , jQuery plugin, etc.) is, in general, preferred to writing the response +directly from within an action. See sections following this for further details. -| **Struts 2 Stream result Action** - -~~~~~~~ +```java package actions; import java.io.InputStream; @@ -52,93 +55,87 @@ public class TextResult extends ActionSupport { return SUCCESS; } } - -~~~~~~~ +``` **Struts 2 Configuring the TextResult Action** - -~~~~~~~ +```xml <action name="text-result" class="actions.TextResult"> <result type="stream"> <param name="contentType">text/html</param> <param name="inputName">inputStream</param> </result> </action> +``` -~~~~~~~ - - (ok) Struts 2 can also return a JSON (JavaScript Object Notation) response, using a [plugin](http://cwiki\.apache\.org/S2PLUGINS/json\-plugin\.html)^[http://cwiki\.apache\.org/S2PLUGINS/json\-plugin\.html]\. - -On the client side, there are two basic strategies, which can be mixed and matched\. - -First, you can use some type of JSP tag\. Here, you don't have to know very much at all about Ajax or JavaScript\. The taglib does all the work, and you just have to figure out how to use the taglib\. The standard Struts 2 taglib includes several _Ajax JSP tags_ , and many third\-party libraries are available, including: - -+ [Ajax Tags](http://ajaxtags\.sourceforge\.net/)^[http://ajaxtags\.sourceforge\.net/] +> Struts 2 can also return a JSON (JavaScript Object Notation) response, using a [plugin](http://cwiki.apache.org/S2PLUGINS/json-plugin.html). -+ [AjaxParts Taglib](http://javawebparts\.sourceforge\.net/)^[http://javawebparts\.sourceforge\.net/] +On the client side, there are two basic strategies, which can be mixed and matched. -+ [ColdTags Suite](http://servletsuite\.blogspot\.com/2006/06/coldtags\-suite\-ajax\-edition\.html)^[http://servletsuite\.blogspot\.com/2006/06/coldtags\-suite\-ajax\-edition\.html] +First, you can use some type of JSP tag. Here, you don't have to know very much at all about Ajax or JavaScript. +The taglib does all the work, and you just have to figure out how to use the taglib. The standard Struts 2 taglib +includes several _Ajax JSP tags_ , and many third-party libraries are available, including: -+ [Prize Tags](http://www\.jenkov\.com/prizetags/introduction\.tmpl)^[http://www\.jenkov\.com/prizetags/introduction\.tmpl] +- [Ajax Tags](http://ajaxtags.sourceforge.net/) +- [AjaxParts Taglib](http://javawebparts.sourceforge.net/) +- [ColdTags Suite](http://servletsuite.blogspot.com/2006/06/coldtags-suite-ajax-edition.html) +- [Prize Tags](http://www.jenkov.com/prizetags/introduction.tmpl) +- [JSON-taglib](http://json-taglib.sourceforge.net/) -+ [JSON\-taglib](http://json\-taglib\.sourceforge\.net/)^[http://json\-taglib\.sourceforge\.net/] +Alternatively, you can use a plain-old Ajax widget on a plain-old HTML page, using libraries like +[Dojo](http://dojotoolkit.org/), [JQuery](http://jquery.com/), or [YUI](http://developer.yahoo.com/yui/), +and the StreamResult or the [JSON Plugin](http://cwiki.apache.org/S2PLUGINS/json-plugin.html). +Here, the sky's the limit, but you actually have to learn something about JavaScript as a language. -Alternatively, you can use a plain\-old Ajax widget on a plain\-old HTML page, using libraries like [Dojo](http://dojotoolkit\.org/)^[http://dojotoolkit\.org/], [JQuery](http://jquery\.com/)^[http://jquery\.com/], or [YUI](http://developer\.yahoo\.com/yui/)^[http://developer\.yahoo\.com/yui/], and the StreamResult or the [JSON Plugin](http://cwiki\.apache\.org/S2PLUGINS/json\-plugin\.html)^[http://cwiki\.apache\.org/S2PLUGINS/json\-plugin\.html]\. Here, the sky's the limit, but you actually have to learn something about JavaScript as a language\. +## Ajax Plugins -####Ajax Plugins#### +While Struts works fine with Ajax out-of-the-box, for added value, several Ajax-centric plugins are available. -While Struts works fine with Ajax out\-of\-the\-box, for added value, several Ajax\-centric plugins are available\. +### Ajax Tag Plugins -#####Ajax Tag Plugins##### +- **jQuery** - The [jQuery Plugin](https://github.com/struts-community-plugins/struts2-jquery) provides ajax + functionality and UI Widgets an JavaScript Grid based on the jQuery javascript framework. +- **Ajax Parts** - The [AjaxParts Taglib (APT)](http://code.google.com/p/struts2ajaxpartstaglibplugin/) is a component + of the Java Web Parts (JWP) project ([http://javawebparts.sourceforge.net](http://javawebparts.sourceforge.net)) that + allows for 100% declarative (read: no Javascript coding required!) AJAX functionality within a Java-based webapp. +- **Dojo** - The _Ajax Tags Dojo Plugin_ was represented as a theme for Struts 2.0. For Struts 2.1, the Dojo tags are + bundled as a plugin until version 2.3.x. Since version 2.5 this plugin is not part of th Struts2 distribution anymore. +- **YUI** - The [Yahoo User Interface (YUI) Plugin](https://code.google.com/p/struts2yuiplugin/) has only a few tags + are available so far, but the YUI tags tend to be easier to use than the Dojo versions. -+ **jQuery** \- The [jQuery Plugin](https://github\.com/struts\-community\-plugins/struts2\-jquery)^[https://github\.com/struts\-community\-plugins/struts2\-jquery] provide ajax functionality and UI Widgets an JavaScript Grid based on the jQuery javascript framework\.** -** +### Other Ajax Plugins -+ **Ajax Parts** \- The [AjaxParts Taglib (APT)](http://code\.google\.com/p/struts2ajaxpartstaglibplugin/)^[http://code\.google\.com/p/struts2ajaxpartstaglibplugin/] is a component of the Java Web Parts (JWP) project ([http://javawebparts\.sourceforge\.net](http://javawebparts\.sourceforge\.net)) that allows for 100% declarative (read: no Javascript coding required\!) AJAX functionality within a Java\-based webapp\. +- **Ajax File Upload** - With the [Ajax File Upload Plugin](http://www.davidjc.com/ajaxfileupload/demo!input.action) + we can upload a file to the server and asynchronously monitor its progress. +- **GWT** - The [Google Web Toolkit Plugin](https://code.google.com/p/struts2gwtplugin/) exposes Struts 2 actions to + the GWT RPC mechanism. +- **JSON** - The _JSON Plugin_ serializes Actions properties into JSON, making it easy to respond to JavaScript requests. -+ **Dojo** \- The _Ajax Tags Dojo Plugin_ was represented as a theme for Struts 2\.0\. For Struts 2\.1, the Dojo tags are bundled as a plugin until version 2\.3\.x\. Since version 2\.5 this plugin is not part of th Struts2 distribution anymore +See the [Struts Plugin Repository](http://cwiki.apache.org/S2PLUGINS/home.html) for a complete list of Struts 2 plugins. -+ **YUI** \- The [Yahoo User Interface (YUI) Plugin](https://code\.google\.com/p/struts2yuiplugin/)^[https://code\.google\.com/p/struts2yuiplugin/] has only a few tags are available so far, but the YUI tags tend to be easier to use than the Dojo versions\. +## Ajax Results with JSP -#####Other Ajax Plugins##### +While server pages are most often used to generate HTML, we can use server pages to create other types of data streams. +Here's an example: -+ **Ajax File Upload** \- With the [Ajax File Upload Plugin](http://www\.davidjc\.com/ajaxfileupload/demo\!input\.action)^[http://www\.davidjc\.com/ajaxfileupload/demo\!input\.action] we can upload a file to the server and asynchronously monitor its progress\. +**book.jsp** -+ **GWT** \- The [Google Web Toolkit Plugin](https://code\.google\.com/p/struts2gwtplugin/)^[https://code\.google\.com/p/struts2gwtplugin/] exposes Struts 2 actions to the GWT RPC mechanism\. - -+ **JSON** \- The _JSON Plugin_ serializes Actions properties into JSON, making it easy to respond to JavaScript requests\. - -See the [Struts Plugin Repository](http://cwiki\.apache\.org/S2PLUGINS/home\.html)^[http://cwiki\.apache\.org/S2PLUGINS/home\.html] for a complete list of Struts 2 plugins\. - -####Ajax Results with JSP#### - -While server pages are most often used to generate HTML, we can use server pages to create other types of data streams\. Here's an example: - -**book\.jsp** - - -~~~~~~~ +```jsp <%@ page import="java.util.Iterator, - java.util.List, - com.esolaria.dojoex.Book, - com.esolaria.dojoex.BookManager" %> + java.util.List, + com.esolaria.dojoex.Book, + com.esolaria.dojoex.BookManager" %> <% - String bookIdStr = request.getParameter("bookId"); - int bookId = (bookIdStr == null || "".equals(bookIdStr.trim())) - ? 0 : Integer.parseInt(bookIdStr); - Book book = BookManager.getBook(bookId); - if (book != null) { - out.println(book.toJSONString()); - System.out.println("itis: " + book.toJSONString()); - } + String bookIdStr = request.getParameter("bookId"); + int bookId = (bookIdStr == null || "".equals(bookIdStr.trim())) + ? 0 : Integer.parseInt(bookIdStr); + Book book = BookManager.getBook(bookId); + if (book != null) { + out.println(book.toJSONString()); + System.out.println("itis: " + book.toJSONString()); + } %> +``` -~~~~~~~ - -In the code example, we use - -~~~~~~~ -System.out.println -~~~~~~~ - to return a JSON data stream as the response\. For more about this technique, see the article [Using Dojo and JSON to Build Ajax Applications](http://today\.java\.net/pub/a/today/2006/04/27/building\-ajax\-with\-dojo\-and\-json\.html)^[http://today\.java\.net/pub/a/today/2006/04/27/building\-ajax\-with\-dojo\-and\-json\.html]\. +In the code example, we use `System.out.println` to return a JSON data stream as the response. For more about this +technique, see the article [Using Dojo and JSON to Build Ajax Applications](http://today.java.net/pub/a/today/2006/04/27/building-ajax-with-dojo-and-json.html).
