RichFaces - obsługa błędów
W tym rozdziale poznamy różne metody obsługi błędów, które można zaimplementować w RichFaces.
Obsługa błędów po stronie serwera i klienta
Musimy przejść przez dość starą technikę Java (try / Catch), aby obsłużyć wyjątki oparte na klasach akcji. Po stronie klienta możemy dodać jeden dodatkowy plik, który pokaże komunikat o błędzie za każdym razem, gdy wystąpi błąd po stronie klienta.
Poniższy fragment kodu można dodać do pliku web.xml w celu obsługi błędów po stronie klienta.
<error-page>
<exception-type>java.lang.Throwable</exception-type>
<location>/error.xhtml</location>
</error-page>
Uwaga, powyższy wyjątek zapewni tylko statyczne komunikaty o wyjątkach i może być konieczne użycie klasy JSF „ExceptionHandler” w celu użycia właściwości dynamicznego wyjątku. W czasie wykonywania RichFaces zapewnia pewne funkcje sprawdzania poprawności pól wejściowych, które mogą być używane jako podstawowy blok konstrukcyjny wyjątku w aplikacji.
Utwórz nowy plik i umieść w nim następujący kod.
<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE html>
<html xmlns = "http://www.w3.org/1999/xhtml"
xmlns:h = "http://java.sun.com/jsf/html"
xmlns:f = "http://java.sun.com/jsf/core"
xmlns:ui = "http://java.sun.com/jsf/facelets"
xmlns:a4j = "http://richfaces.org/a4j"
xmlns:rich = "http://richfaces.org/rich">
<h:head>
<title>Error handling</title>
<meta name = "viewport" content = "width = device-width, initial-scale = 1.0"/>
</h:head>
<h:body>
<h:form id = "form">
<rich:panel>
<f:facet name = "header">
<h:panelGroup>
<h:outputText value = "Student Registration" />
<a4j:status>
<f:facet name = "start">
<h:graphicImage value = "/images/ai.gif" style = "height:12px;width:12px;" alt = "ai" />
</f:facet>
</a4j:status>
</h:panelGroup>
</f:facet>
<h:panelGrid columns = "3">
<h:outputText value = "Name:" />
<h:inputText value = "#{student.name}" id = "name" label = "name">
<f:validateLength minimum = "3" maximum = "8" />
<f:validateRequired />
<rich:validator />
</h:inputText>
<rich:message for = "name" />
<h:outputText value = "Email" />
<h:inputText value = "#{student.email}" id = "email"
validatorMessage = "Ivalid email address">
<f:validateRegex
pattern =
"^(([a-zA-Z0-9_\-\.]+)@([a-zA-Z0-9_\-\.]+)
\.([a-zAZ]{2,5}){1,25})+([;.](([a-zA-Z0-9_\-\.]+)
@([a-zA-Z0-9_\-\.]+)\.([a-zAZ]{2,5}){1,25})+)*$" />
<rich:validator />
</h:inputText>
<rich:message for = "email" />
<h:outputText value = "Age" />
<h:inputText value = "#{student.age}" id = "age" label = "age">
<f:validateLongRange minimum = "18" maximum = "99" />
<rich:validator />
</h:inputText>
<rich:message for = "age" />
</h:panelGrid>
</rich:panel>
</h:form>
</h:body>
</html>
Odpowiednia klasa java powinna być zwykłą klasą bean, jak poniżej.
import javax.faces.bean.ManagedBean;
import javax.faces.bean.RequestScoped;
@ManagedBean
@RequestScoped
public class Student {
private String name;
private String email;
private int age;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}
Powyższy przykład przyniesie następujące wyniki w przeglądarce, ilekroć wystąpi błąd w <h: form>.
Ładowanie zasobów
RichFaces usprawnia standardową procedurę obsługi zasobów w aplikacji JSF. Można to zaimplementować poprzez skonfigurowanie ResourceServlet lub przez optymalizację zasobów. Aby skonfigurować ResourceServlet, musimy dodać następujący fragment kodu w web.xml.
<servlet>
<servlet-name>Resource Servlet</servlet-name>
<servlet-class>org.richfaces.webapp.ResourceServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Resource Servlet</servlet-name>
<url-pattern>/org.richfaces.resources/*</url-pattern>
</servlet-mapping>
Możemy również włączyć optymalizację w aplikacji JSF, która zoptymalizuje różne pliki JavaScript i CSS. Musimy dodać następujący kod, aby uzyskać optymalizację w aplikacji.
<context-param>
<param-name>org.richfaces.resourceOptimization.enabled</param-name>
<param-value>true</param-value>
</context-param>