Servlety všeobecne

(všeobecný) servlet je podtriedou abstraktnej triedy javax.servlet.GenericServlet, takmer výhradne sú však používané:

servlety nad HTTP, čiže podtriedy abstraktnej triedy javax.servlet.HttpServlet.

Životný cyklus servletu

Medzi servletmi a CGI skriptami je niekoľko závažných rozdielov počas ich životného cyklu.

CGI skripty

server prijme požiadavku
server spustí program spracovávajúci CGI skript
server odošle výsledok spracovanie skriptu ako odpoveď na požiadavku

Servlety

pri spustení webaplikácie server vytvorí jednu, či viac inštancií triedy príslušného servletu
server prijme požiadavku, odošle ju servletu na spracovanie
server odošle výstup vytvorený servletom ako odpoveď na požiadavku

Najväčší rozdiel medzi týmito prístupmi

CGI skripty sa s každou požiadavkou spúšťajú raz

servlet sa spustí len raz (vytvorí sa jedna (či viac) inštancií), ktoré vybavujú požiadavky

Servlet odosielajúci čistý text

Trieda HelloServlet vypisujúca jednoduchý string "Ahoj, svet!".

  package aiz;

  import javax.servlet.*;
  import javax.servlet.http.*;

  import java.io.PrintWriter;

  public class FirstServlet extends HttpServlet {
      protected void doGet(HttpServletRequest req, HttpServletResponse resp)
          throws ServletException, java.io.IOException {

          PrintWriter out = resp.getWriter();
          out.println("Ahoj, svet!");
      }

  }

HTTP servlet je podtriedou triedy javax.servlet.http.HttpServlet

najdôležitejšie metódy

`init(..)`	vykonávaná pri načítavaní servletu serverom
`doGet(..)`	na spracovanie údajov odoslaných cez HTTP GET -- implicitná HTTP metóda
`doPost(..)`	na spracovanie údajov odoslaných cez HTTP POST

Je potrebné preťažiť aspoň jednu metódu typu do*.

parameter HttpServletRequest req -- spravuje dáta odoslané zo stránky -- request (dáta formulárov a pod.)
parameter HttpServletResponse response -- metódy na odosielanie dát späť užívateľovi -- response (výpis HTML kódu, HTTP hlavičky...)

PrintWriter out = resp.getWriter() získa objekt PrintWriter, pomocou neho možno zapisovať ľubovoľný text -- metódou out.println(String reťazec)

Servlet odosielajúci HTML

čistý text nie je vizuálne príťažlivý
HTML je vlastne text -- môžeme ho využiť v reťazcoch zapisovaných pomocou out.println(..)
je potrebné nastaviť MIME typ odosielaných údajov -- implicitne je to text/html.
```
    resp.setContentType("text/html; charset=windows-1250");
  
```

zároveň nastavíme kódovú stránku (tu: windows-1250)

  package aiz;

  import javax.servlet.*;
  import javax.servlet.http.*;

  import java.io.PrintWriter;

  public class FirstServlet extends HttpServlet {
      protected void doGet(HttpServletRequest req, HttpServletResponse resp)
          throws ServletException, java.io.IOException {

          resp.setContentType("text/html; charset=windows-1250");

          PrintWriter out = resp.getWriter();
          out.println("<i>Ľahtikársky kôň v húští <u>mäkkučko</u> úpel <b>matiné</b> ťaživých ód!</i>");

      }
  }

HTML Formuláre a servlety

komunikácia na stránkach v smere užívateľ -> aplikácia -- najčastejšie cez formuláre

    <html>
    <head>
      <META http-equiv="Content-Type" content="text/html; charset=windows-1250">
    </head>
    <body>
    <table width=100% height=100%>
    <tr>
    <td align=center valign=middle>
      <form action="/sps/servlet/aiz.LoginServlet" method="GET">
        Prihlasovacie meno: <input type="text" name="username"><br>
        Heslo: <input type="password" name="password" ><br>
        <br>
        <input type="submit" name="submit" value="Prihlásiť">
      </form>
    </td>
    </tr>
    </table>
    </body>
    </html>

formulár (HTML tag <form>):
- atribút action="adresaURL" určuje URL adresu prostriedku, ktorý bude údaje z formulára spracovávať (napr. adresa servletu)
- atribút method="typMetódy" určuje HTTP metódu odosielania údajov. Implicitná metódy je GET (method="GET"), prípustná je POST (method="POST")

servlet spracúvajúci dáta z formulára

  package aiz;

  import javax.servlet.*;
  import javax.servlet.http.*;

  import java.io.PrintWriter;
  import java.util.Enumeration;

  public class FormServlet extends HttpServlet {
      protected String decodeParameter(String parameter) {
        try {
          return new String(parameter.getBytes("ISO-8859-1"), "windows-1250");
        } catch (Exception e) {
          return parameter;
        }
      }

      protected void doGet(HttpServletRequest req, HttpServletResponse resp)
          throws ServletException, java.io.IOException {

          resp.setContentType("text/html; charset=windows-1250");
          PrintWriter out = resp.getWriter();
          out.println("<ul>");
          /* metóda getParameterNames() vráti názvy jednotlivých
          /  parametrov, ktoré boli odovzdané metódou GET.
          */
          for(Enumeration e = req.getParameterNames(); e.hasMoreElements(); ) {
            String parameterName = (String) e.nextElement();
            /* metóda getParameterName(String name) vráti hodnotu parametra
               s názvom name, alebo null, ak taký parameter neexistuje.
            */
            String parameterValue = decodeParameter(req.getParameter(parameterName));
            out.println("<li>" + parameterName + " = " + parameterValue + "</li>");
          }
          out.println("</ul>");
      }

      protected void doPost(HttpServletRequest req, HttpServletResponse resp)
          throws ServletException, java.io.IOException {

      }
  }

každému ovládaciemu prvku vo formulári zodpovedá dvojica (názov ovládacieho prvku; hodnota).
- názov ovládacieho prvku -- podľa atribútu name v HTML
- hodnota -- buď obsah ovládacieho prvku, alebo hodnota atribútu value v HTML
```
<input type="typOvládaciehoPrvku" name="názovOvládaciehoPrvku">
```

získanie hodnoty

String hodnota = (String)req.getParameter(String názovOvládaciehoPrvku)

pozor! -- reťazec hodnota môže byť
- prázdny (platí hodnota.equals("") == true)
- null -- ak neexistuje parameter s príslušným názvom
konverzia medzinárodných znakov
- nejednoznačná podpora pri odosielaní medzinárodných znakov
- ,,štandardná" kódová stránka -- ISO-8859-1
- konverzia hodnoty parametra:
```
String hodnota = new String(hodnota.getBytes("ISO-8859-1"), "windows-1250");
```