The encoder Example: Using Alternatives (original) (raw)

The encoder example shows how to use alternatives to choose between two beans at deployment time, as described in Using Alternatives in CDI Applications. The example includes an interface and two implementations of it, a managed bean, a Facelets page, and configuration files.

The Coder Interface and Implementations

The Coder interface contains just one method, codeString, that takes two arguments: a string, and an integer value that specifies how the letters in the string should be transposed.

public interface Coder {

public String codeString(String s, int tval);

}

The interface has two implementation classes, CoderImpl and TestCoderImpl. The implementation ofcodeString in CoderImpl shifts the string argument forward in the alphabet by the number of letters specified in the second argument; any characters that are not letters are left unchanged. (This simple shift code is known as a Caesar cipher, for Julius Caesar, who reportedly used it to communicate with his generals.) The implementation in TestCoderImpl merely displays the values of the arguments. The TestCoderImplimplementation is annotated @Alternative:

import javax.enterprise.inject.Alternative;

@Alternative public class TestCoderImpl implements Coder {

public String codeString(String s, int tval) {
    return ("input string is " + s + ", shift value is " + tval);
}

}

The beans.xml file for the encoder example contains an alternatives element for theTestCoderImpl class, but by default the element is commented out:

This means that by default, the TestCoderImpl class, annotated @Alternative, will not be used. Instead, the CoderImpl class will be used.

The encoder Facelets Page and Managed Bean

The simple Facelets page for the encoder example, index.xhtml, asks the user to type the string and integer values and passes them to the managed bean, CoderBean, as coderBean.inputString and coderBean.transVal:

String Encoder

Type a string and an integer, then click Encode.

Depending on which alternative is enabled, the coder bean will either display the argument values or return a string that shifts the letters in the original string by the value you specify. The value must be between 0 and 26.

...

When the user clicks the Encode button, the page invokes the managed bean’sencodeString method and displays the result, coderBean.codedString, in blue. The page also has a Reset button that clears the fields.

The managed bean, CoderBean, is a @RequestScoped bean that declares its input and output properties. The transVal property has three Bean Validation constraints that enforce limits on the integer value, so that if the user types an invalid value, a default error message appears on the Facelets page. The bean also injects an instance of the Coder interface:

@Named @RequestScoped public class CoderBean {

private String inputString;
private String codedString;
@Max(26)
@Min(0)
@NotNull
private int transVal;

@Inject
Coder coder;
...

In addition to simple getter and setter methods for the three properties, the bean defines the encodeString action method called by the Facelets page. This method sets the codedString property to the value returned by a call to thecodeString method of the Coder implementation:

public void encodeString() {
    setCodedString(coder.codeString(inputString, transVal));
}

Finally, the bean defines the reset method to empty the fields of the Facelets page:

public void reset() {
    setInputString("");
    setTransVal(0);
}

Running the encoder Example

You can use either NetBeans IDE or Ant to build, package, deploy, and run the encoder application.

To Build, Package, and Deploy the encoder Example Using NetBeans IDE

From the File menu, choose Open Project.
In the Open Project dialog, navigate to:
tut-install/examples/cdi/
Select the encoder folder.
Select the Open as Main Project check box.
Click Open Project.
In the Projects tab, right-click the encoder project and select Deploy.

To Run the encoder Example Using NetBeans IDE

In a web browser, type the following URL:
http://localhost:8080/encoder
The String Encoder page opens.
Type a string and the number of letters to shift by, then click Encode.
The encoded string appears in blue on the Result line. For example, if you type Java and 4, the result is Neze.
Now, edit the beans.xml file to enable the alternative implementation of Coder.
1. In the Projects tab, under the encoder project, expand the Web Pages node, then the WEB-INF node.
2. Double-click the beans.xml file to open it.
3. Remove the comment characters that surround the alternatives element, so that it looks like this: encoder.TestCoderImpl
4. Save the file.
Right-click the encoder project and select Deploy.
In the web browser, retype the URL to show the String Encoder page for the redeployed project:
http://localhost:8080/encoder/
Type a string and the number of letters to shift by, then click Encode.
This time, the Result line displays your arguments. For example, if you typeJava and 4, the result is:
Result: input string is Java, shift value is 4

To Build, Package, and Deploy the encoder Example Using Ant

In a terminal window, go to:
tut-install/examples/cdi/encoder/
Type the following command:
ant
This command calls the default target, which builds and packages the application into a WAR file, encoder.war, located in the dist directory.
Type the following command:
ant deploy

To Run the encoder Example Using Ant

In a web browser, type the following URL:
http://localhost:8080/encoder/
The String Encoder page opens.
Type a string and the number of letters to shift by, then click Encode.
The encoded string appears in blue on the Result line. For example, if you type Java and 4, the result is Neze.
Now, edit the beans.xml file to enable the alternative implementation of Coder.
1. In a text editor, open the following file:
  tut-install/examples/cdi/encoder/web/WEB-INF/beans.xml
2. Remove the comment characters that surround the alternatives element, so that it looks like this: encoder.TestCoderImpl
3. Save and close the file.
Type the following commands:
ant undeploy
ant
ant deploy
In the web browser, retype the URL to show the String Encoder page for the redeployed project:
http://localhost:8080/encoder
Type a string and the number of letters to shift by, then click Encode.
This time, the Result line displays your arguments. For example, if you typeJava and 4, the result is:
Result: input string is Java, shift value is 4