Programming WebLogic HTTP Servlets
The following sections introduce basic HTTP servlet programming:
The section provides a procedure for writing a simple HTTP servlet, which prints out the message Hello World. A complete code example (the HelloWorldServlet
) illustrating these steps is included at the end of this section. Additional information about using various J2EE and Weblogic Server services such as JDBC, RMI, and JMS, in your servlet are discussed later in this document.
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
public class HelloWorldServlet extends HttpServlet{
The main function of a servlet is to accept an HTTP request from a Web browser, and return an HTTP response. This work is done by the service()
method of your servlet. Service methods include response objects used to create output and request objects used to receive data from the client.
You may have seen other servlet examples implement the doPost()
and/or doGet()
methods. These methods reply only to POST or GET requests; if you want to handle all request types from a single method, your servlet can simply implement the service()
method. (However, if you choose to implement the service()
method, you cannot implement the doPost()
or doGet()
methods, unless you call super.service()
at the beginning of the service()
method.) The HTTP servlet specification describes other methods used to handle other request types, but all of these methods are collectively referred to as service methods.
All the service methods take the same parameter arguments. An HttpServletRequest
provides information about the request, and your servlet uses an HttpServletResponse
to reply to the HTTP client. The service method looks like the following:
public void service(HttpServletRequest req,
HttpServletResponse res) throws IOException
{
res.setContentType("text/html");
PrintWriter out = res.getWriter();
println()
method on the PrintWriter
object, as shown in the following example:out.println("<html><head><title>Hello World!</title></head>");
out.println("<body><h1>Hello World!</h1></body></html>");
}
}
WEB-INF/classes
directory of the Web Application that contains your servlet. For example:javac -d /myWebApplication/WEB-INF/classes myServlet.java
The URL you use to call a servlet is determined by: (a) the name of the Web Application containing the servlet and (b) the name of the servlet as mapped in the deployment descriptor of the Web Application. Request parameters can also be included in the URL used to call a servlet.
Generally the URL for a servlet conforms to the following:
http://host:port/webApplicationName/mappedServletName?parameter
host
is the name of the machine running WebLogic Server.port
is the port at which the above machine is listening for HTTP requests.webApplicationName
is the name of the Web Application containing the servlet.For example, to use a Web browser to call the HelloWorldServlet
(the example featured in this document), which is deployed in the examplesWebApp
and served from a WebLogic Server running on your machine, enter the following URL:
http://localhost:7001/examplesWebApp/HelloWorldServlet
The host
:
port
portion of the URL can be replaced by a DNS name that is mapped to WebLogic Server.
The preceding steps create a basic servlet. You will probably also use more advanced features of servlets:
init()
method.
This section provides the complete Java source code for the example used in the preceding procedure. The example is a simple servlet that provides a response to an HTTP request. Later in this document, this example is expanded to illustrate how to use HTTP parameters, cookies, and session tracking.
Listing 2-1 HelloWorldServlet.java
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
public class HelloWorldServlet extends HttpServlet {
public void service(HttpServletRequest req,
HttpServletResponse res)
throws IOException
{
// Must set the content type first
res.setContentType("text/html");
// Now obtain a PrintWriter to insert HTML into
PrintWriter out = res.getWriter();
out.println("<html><head><title>" +
"Hello World!</title></head>");
out.println("<body><h1>Hello World!</h1></body></html>");
}
}
You can find the source code and instructions for compiling and running all the examples used in this document in the samples/examples/servlets
directory of your WebLogic Server distribution.