Skip to content

Commit

Permalink
First pass at JSF (#157)
Browse files Browse the repository at this point in the history
* First pass at JSF

Renamed Jakarta Faces

* Renamed to Jakarta Server Faces

Update jsf-ajax.adoc

Update jsf-ajax002.adoc

Update jsf-ajax011.adoc

Update jsf-ajax012.adoc

Update jsf-configure.adoc

Update jsf-configure001.adoc

Update jsf-configure013.adoc

Update jsf-intro.adoc

Update jsf-intro001.adoc

Update jsf-intro002.adoc

Update jsf-intro003.adoc

Update jsf-intro004.adoc

Update jsf-intro007.adoc

Update jsf-intro009.adoc

Update jsf-intro007.adoc

Update jsf-page.adoc

Update jsf-ws.adoc

Signed-off-by: Guillermo González de Agüero <z06.guillermo@gmail.com>
  • Loading branch information
ggam authored and bshannon committed Sep 16, 2019
1 parent 4701923 commit c97392b
Show file tree
Hide file tree
Showing 74 changed files with 457 additions and 457 deletions.
2 changes: 1 addition & 1 deletion src/main/jbake/content/jsf-advanced-cc.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Composite Components: Advanced Topics and an Example


This chapter describes the advanced features of composite components in
JavaServer Faces technology.
Jakarta Server Faces technology.

The following topics are addressed here:

Expand Down
2 changes: 1 addition & 1 deletion src/main/jbake/content/jsf-advanced-cc001.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ prev=jsf-advanced-cc.html
Attributes of a Composite Component
-----------------------------------

A composite component is a special type of JavaServer Faces template
A composite component is a special type of Jakarta Server Faces template
that acts as a component. If you are new to composite components, see
link:jsf-facelets005.html#GIQZR[Composite Components] before you proceed
with this chapter.
Expand Down
2 changes: 1 addition & 1 deletion src/main/jbake/content/jsf-advanced-cc003.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ prev=jsf-advanced-cc002.html
Validating Composite Component Values
-------------------------------------

JavaServer Faces provides the following tags for validating values of
Jakarta Server Faces provides the following tags for validating values of
input components. These tags can be used with the
`composite:valueHolder` or the `composite:editableValueHolder` tag.

Expand Down
18 changes: 9 additions & 9 deletions src/main/jbake/content/jsf-ajax.adoc
Original file line number Diff line number Diff line change
@@ -1,30 +1,30 @@
type=page
status=published
title=Using Ajax with JavaServer Faces Technology
title=Using Ajax with Jakarta Server Faces Technology
next=jsf-ajax001.html
prev=jsf-develop003.html
~~~~~~
Using Ajax with JavaServer Faces Technology
===========================================
Using Ajax with Jakarta Server Faces Technology
===============================================

[[GKIOW]][[using-ajax-with-javaserver-faces-technology]]

13 Using Ajax with JavaServer Faces Technology
----------------------------------------------
13 Using Ajax with Jakarta Server Faces Technology
--------------------------------------------------


This chapter describes using Ajax functionality in JavaServer Faces web
This chapter describes using Ajax functionality in Jakarta Server Faces web
applications. Ajax is an acronym for Asynchronous JavaScript and XML, a
group of web technologies that enable creation of dynamic and highly
responsive web applications. Using Ajax, web applications can retrieve
content from the server without interfering with the display on the
client. In the Jakarta EE platform, JavaServer Faces technology provides
client. In the Jakarta EE platform, Jakarta Server Faces technology provides
built-in support for Ajax.

The following topics are addressed here:

* link:jsf-ajax001.html#GKIGR[Overview of Ajax]
* link:jsf-ajax002.html#GKINL[Using Ajax Functionality with JavaServer
* link:jsf-ajax002.html#GKINL[Using Ajax Functionality with Jakarta Server
Faces Technology]
* link:jsf-ajax003.html#GKABR[Using Ajax with Facelets]
* link:jsf-ajax004.html#GKACE[Sending an Ajax Request]
Expand All @@ -36,6 +36,6 @@ Faces Technology]
* link:jsf-ajax010.html#GKAAM[Loading JavaScript as a Resource]
* link:jsf-ajax011.html#GKOKB[The ajaxguessnumber Example Application]
* link:jsf-ajax012.html#GKSDK[Further Information about Ajax in
JavaServer Faces Technology]
Jakarta Server Faces Technology]
2 changes: 1 addition & 1 deletion src/main/jbake/content/jsf-ajax001.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Ajax refers to JavaScript and XML, technologies that are widely used for
creating dynamic and asynchronous web content. While Ajax is not limited
to JavaScript and XML technologies, more often than not they are used
together by web applications. The focus of this tutorial is on using
JavaScript based Ajax functionality in JavaServer Faces web
JavaScript based Ajax functionality in Jakarta Server Faces web
applications.

JavaScript is a dynamic scripting language for web applications. It
Expand Down
18 changes: 9 additions & 9 deletions src/main/jbake/content/jsf-ajax002.adoc
Original file line number Diff line number Diff line change
@@ -1,36 +1,36 @@
type=page
status=published
title=Using Ajax Functionality with JavaServer Faces Technology
title=Using Ajax Functionality with Jakarta Server Faces Technology
next=jsf-ajax003.html
prev=jsf-ajax001.html
~~~~~~
Using Ajax Functionality with JavaServer Faces Technology
=========================================================
Using Ajax Functionality with Jakarta Server Faces Technology
=============================================================

[[GKINL]][[using-ajax-functionality-with-javaserver-faces-technology]]

Using Ajax Functionality with JavaServer Faces Technology
---------------------------------------------------------
Using Ajax Functionality with Jakarta Server Faces Technology
-------------------------------------------------------------

Ajax functionality can be added to a JavaServer Faces application in one
Ajax functionality can be added to a Jakarta Server Faces application in one
of the following ways:

* Adding the required JavaScript code to an application
* Using the built-in Ajax resource library
In earlier releases of the Jakarta EE platform, JavaServer Faces
In earlier releases of the Jakarta EE platform, Jakarta Server Faces
applications provided Ajax functionality by adding the necessary
JavaScript to the web page. In the Jakarta EE platform, standard Ajax
support is provided by a built-in JavaScript resource library.

With the support of this JavaScript resource library, JavaServer Faces
With the support of this JavaScript resource library, Jakarta Server Faces
standard UI components, such as buttons, labels, or text fields, can be
enabled for Ajax functionality. You can also load this resource library
and use its methods directly from within the managed bean code. The next
sections of the tutorial describe the use of the built-in Ajax resource
library.

In addition, because the JavaServer Faces technology component model can
In addition, because the Jakarta Server Faces technology component model can
be extended, custom components can be created with Ajax functionality.

The tutorial examples include an Ajax version of the `guessnumber`
Expand Down
8 changes: 4 additions & 4 deletions src/main/jbake/content/jsf-ajax003.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,10 +12,10 @@ prev=jsf-ajax002.html
Using Ajax with Facelets
------------------------

As mentioned in the previous section, JavaServer Faces technology
As mentioned in the previous section, Jakarta Server Faces technology
supports Ajax by using a built-in JavaScript resource library that is
provided as part of the JavaServer Faces core libraries. This built-in
Ajax resource can be used in JavaServer Faces web applications in one of
provided as part of the Jakarta Server Faces core libraries. This built-in
Ajax resource can be used in Jakarta Server Faces web applications in one of
the following ways.

* By using the `f:ajax` tag along with another standard component in a
Expand All @@ -34,7 +34,7 @@ server-side method via Ajax.
Using the f:ajax Tag
~~~~~~~~~~~~~~~~~~~~

The `f:ajax` tag is a JavaServer Faces core tag that provides Ajax
The `f:ajax` tag is a Jakarta Server Faces core tag that provides Ajax
functionality to any regular UI component when used in conjunction with
that component. In the following example, Ajax behavior is added to an
input component by including the `f:ajax` core tag:
Expand Down
2 changes: 1 addition & 1 deletion src/main/jbake/content/jsf-ajax004.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ a|

Behind the scenes, the `jsf.ajax.request()` method of the JavaScript
resource library collects the data provided by the `f:ajax` tag and
posts the request to the JavaServer Faces lifecycle.
posts the request to the Jakarta Server Faces lifecycle.

|=======================================================================

Expand Down
4 changes: 2 additions & 2 deletions src/main/jbake/content/jsf-ajax005.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ Monitoring Events on the Client

To monitor ongoing Ajax requests, use the `onevent` attribute of the
`f:ajax` tag. The value of this attribute is the name of a JavaScript
function. JavaServer Faces calls the `onevent` function at each stage of
function. Jakarta Server Faces calls the `onevent` function at each stage of
the processing of an Ajax request: begin, complete, and success.

When calling the JavaScript function assigned to the `onevent` property,
JavaServer Faces passes a data object to it. The data object contains
Jakarta Server Faces passes a data object to it. The data object contains
the properties listed in link:#GKGOE[Table 13-3].

[[sthref71]][[GKGOE]]
Expand Down
4 changes: 2 additions & 2 deletions src/main/jbake/content/jsf-ajax006.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@ prev=jsf-ajax005.html
Handling Errors
---------------

JavaServer Faces handles Ajax errors through use of the `onerror`
Jakarta Server Faces handles Ajax errors through use of the `onerror`
attribute of the `f:ajax` tag. The value of this attribute is the name
of a JavaScript function.

When there is an error in processing a Ajax request, JavaServer Faces
When there is an error in processing a Ajax request, Jakarta Server Faces
calls the defined `onerror` JavaScript function and passes a data object
to it. The data object contains all the properties available for the
`onevent` attribute and, in addition, the following properties:
Expand Down
2 changes: 1 addition & 1 deletion src/main/jbake/content/jsf-ajax007.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Receiving an Ajax Response
After the application sends an Ajax request, it is processed on the
server side, and a response is sent back to the client. As described
earlier, Ajax allows for partial updating of web pages. To enable such
partial updating, JavaServer Faces technology allows for partial
partial updating, Jakarta Server Faces technology allows for partial
processing of the view. The handling of the response is defined by the
`render` attribute of the `f:ajax` tag.

Expand Down
10 changes: 5 additions & 5 deletions src/main/jbake/content/jsf-ajax008.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ Ajax Request Lifecycle
Ajax Request Lifecycle
----------------------

An Ajax request varies from other typical JavaServer Faces requests, and
its processing is also handled differently by the JavaServer Faces
An Ajax request varies from other typical Jakarta Server Faces requests, and
its processing is also handled differently by the Jakarta Server Faces
lifecycle.

As described in link:jsf-intro008.html#GKNOJ[Partial Processing and
Expand All @@ -27,14 +27,14 @@ tree processing and rendering.

The `execute` attribute of the `f:ajax` tag identifies which segments of
the server-side component tree should be processed. Because components
can be uniquely identified in the JavaServer Faces component tree, it is
can be uniquely identified in the Jakarta Server Faces component tree, it is
easy to identify and process a single component, a few components, or a
whole tree. This is made possible by the `visitTree` method of the
`UIComponent` class. The identified components then run through the
JavaServer Faces request lifecycle phases.
Jakarta Server Faces request lifecycle phases.

Similar to the `execute` attribute, the `render` attribute identifies
which segments of the JavaServer Faces component tree need to be
which segments of the Jakarta Server Faces component tree need to be
rendered during the render response phase.

During the render response phase, the `render` attribute is examined.
Expand Down
4 changes: 2 additions & 2 deletions src/main/jbake/content/jsf-ajax010.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,9 @@ prev=jsf-ajax009.html
Loading JavaScript as a Resource
--------------------------------

The JavaScript resource file bundled with JavaServer Faces technology is
The JavaScript resource file bundled with Jakarta Server Faces technology is
named `jsf.js` and is available in the `javax.faces` library. This
resource library supports Ajax functionality in JavaServer Faces
resource library supports Ajax functionality in Jakarta Server Faces
applications.

If you use the `f:ajax` tag on a page, the `jsf.js` resource is
Expand Down
2 changes: 1 addition & 1 deletion src/main/jbake/content/jsf-ajax011.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -147,7 +147,7 @@ DukesNumberBean dukesNumberBean;
----

You will learn more about CDI in link:cdi-basic.html#GIWHB[Chapter 25,
"Introduction to Contexts and Dependency Injection for Jakarta EE"].
"Introduction to Jakarta Contexts and Dependency Injection"].

[[GKOKE]][[running-the-ajaxguessnumber-example]]

Expand Down
14 changes: 7 additions & 7 deletions src/main/jbake/content/jsf-ajax012.adoc
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
type=page
status=published
title=Further Information about Ajax in JavaServer Faces Technology
title=Further Information about Ajax in Jakarta Server Faces Technology
next=jsf-advanced-cc.html
prev=jsf-ajax011.html
~~~~~~
= Further Information about Ajax in JavaServer Faces Technology
= Further Information about Ajax in Jakarta Server Faces Technology


[[GKSDK]][[further-information-about-ajax-in-javaserver-faces-technology]]

Further Information about Ajax in JavaServer Faces Technology
-------------------------------------------------------------
Further Information about Ajax in Jakarta Server Faces Technology
-----------------------------------------------------------------

For more information on Ajax in JavaServer Faces Technology, see
For more information on Ajax in Jakarta Server Faces Technology, see

* JavaServer Faces project website:
* Jakarta Server Faces project website:
+
`https://javaserverfaces.github.io/users.html`
* link:../javaserver-faces-2-2/jsdocs/symbols/jsf.ajax.html[JavaServer
* link:../javaserver-faces-2-2/jsdocs/symbols/jsf.ajax.html[Jakarta Server
Faces JavaScript Library APIs]
14 changes: 7 additions & 7 deletions src/main/jbake/content/jsf-configure.adoc
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
type=page
status=published
title=Configuring JavaServer Faces Applications
title=Configuring Jakarta Server Faces Applications
next=jsf-configure001.html
prev=jsf-custom014.html
~~~~~~
Configuring JavaServer Faces Applications
=========================================
Configuring Jakarta Server Faces Applications
=============================================

[[BNAWO]][[configuring-javaserver-faces-applications]]

16 Configuring JavaServer Faces Applications
--------------------------------------------
16 Configuring Jakarta Server Faces Applications
------------------------------------------------


This chapter describes additional configuration tasks required when you
Expand All @@ -19,7 +19,7 @@ create large and complex applications.
The following topics are addressed here:

* link:jsf-configure001.html#A1352824[Introduction to Configuring
JavaServer Faces Applications]
Jakarta Server Faces Applications]
* link:jsf-configure002.html#GIRCH[Using Annotations to Configure Managed
Beans]
* link:jsf-configure003.html#BNAWP[Application Configuration Resource
Expand All @@ -34,7 +34,7 @@ File]
* link:jsf-configure011.html#BNAXH[Registering a Custom Renderer with a
Render Kit]
* link:jsf-configure012.html#BNAXI[Registering a Custom Component]
* link:jsf-configure013.html#BNAXJ[Basic Requirements of a JavaServer
* link:jsf-configure013.html#BNAXJ[Basic Requirements of a Jakarta Server
Faces Application]
14 changes: 7 additions & 7 deletions src/main/jbake/content/jsf-configure001.adoc
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
type=page
status=published
title=Introduction to Configuring JavaServer Faces Applications
title=Introduction to Configuring Jakarta Server Faces Applications
next=jsf-configure002.html
prev=jsf-configure.html
~~~~~~
Introduction to Configuring JavaServer Faces Applications
=========================================================
Introduction to Configuring Jakarta Server Faces Applications
=============================================================

[[A1352824]][[introduction-to-configuring-javaserver-faces-applications]]

Introduction to Configuring JavaServer Faces Applications
---------------------------------------------------------
Introduction to Configuring Jakarta Server Faces Applications
-------------------------------------------------------------

The process of building and deploying simple JavaServer Faces
The process of building and deploying simple Jakarta Server Faces
applications is described in earlier chapters of this tutorial,
including link:webapp.html#BNADR[Chapter 6, "Getting Started with Web
Applications,"] link:jsf-facelets.html#GIEPX[Chapter 8, "Introduction to
Facelets,"] link:jsf-ajax.html#GKIOW[Chapter 13, "Using Ajax with
JavaServer Faces Technology,"] and
Jakarta Server Faces Technology,"] and
link:jsf-advanced-cc.html#GKHXA[Chapter 14, "Composite Components:
Advanced Topics and an Example."] When you create large and complex
applications, however, various additional configuration tasks are
Expand Down
12 changes: 6 additions & 6 deletions src/main/jbake/content/jsf-configure002.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,19 +18,19 @@ Using Annotations to Configure Managed Beans
a|
[.lead]
*Note*:
In JSF 2.3, managed bean annotations are deprecated; CDI is now the
In Jakarta Server Faces 2.3, managed bean annotations are deprecated; CDI is now the
preferred approach.

|=======================================================================


JavaServer Faces support for bean annotations is introduced in
link:jsf-intro.html#BNAPH[Chapter 7, "JavaServer Faces Technology"]. Bean
annotations can be used for configuring JavaServer Faces applications.
Jakarta Server Faces support for bean annotations is introduced in
link:jsf-intro.html#BNAPH[Chapter 7, "Jakarta Server Faces Technology"]. Bean
annotations can be used for configuring Jakarta Server Faces applications.

The `@Named` (`javax.inject.Named`) annotation in a class, along with a
scope annotation, automatically registers that class as a resource with
the JavaServer Faces implementation. A bean that uses these annotations
the Jakarta Server Faces implementation. A bean that uses these annotations
is a CDI managed bean.

The following shows the use of the `@Named` and `@SessionScoped`
Expand All @@ -43,7 +43,7 @@ annotations in a class:
public class ShoppingCart ... { ... }
----

The above code snippet shows a bean that is managed by the JavaServer
The above code snippet shows a bean that is managed by the Jakarta Server
Faces implementation and is available for the length of the session.

You can annotate beans with any of the scopes listed in the next
Expand Down

0 comments on commit c97392b

Please sign in to comment.