Package java.net : java.net.ServerSocket

Чтобы сделать сокет, который будет обслуживать сервер в джава существует класс  java.net.ServerSocket :

 

public ServerSocket(int port, int backlog, InetAddress bindAddr) throws IOException

 

После установки сокета, вызывается функция

 

public Socket accept() throws IOException 

 

Эта функция погружает программу в ожидание того момента, когда клиент будет присоединяться к сокету сервера. Как только соединение установлено, функция возвратит объект класса Socket для общения с клиентом.

Если во время запуска программы-сервера, вместо строки 

 

"server is started" 

 

выдало строку типа

 

init error: java.net.BindException: Address already  in use: JVM_Bind 

то это будет обозначать, что порт 3128 на вашем компьютере уже занят какой-либо программой или запрещён к применению

TCP/IP: Программа простого TCP/IP клиента

import java.io.*;  import java.net.*;  class SampleClient extends Thread 

{

 public static void main(String args[]) 

 {

 try { // открываем сокет и коннектимся к localhost:3128 

// получаем сокет сервера 

Socket s = new Socket("localhost", 3128); // берём поток вывода и выводим туда первый аргумент 

// заданный при вызове, адрес открытого сокета и его порт  args[0] = args[0]+"\n"+s.getInetAddress().getHostAddress() +":"+s.getLocalPort(); 

 

s.getOutputStream().write(args[0].getBytes());   // читаем ответ byte buf[] = new byte[64*1024];  int r = s.getInputStream().read(buf);

 String data = new String(buf, 0, r); // выводим ответ в консоль System.out.println(data); 

} catch(Exception e) 

{

        System.out.println("init error: "+e);

TCP/IP: Программа простого TCP/IP сервера

import java.io.*;  import java.net.*;  class SampleServer extends Thread 

{

   Socket s;     int num;     public static void main(String args[]) 

  {      try { 

         int i = 0; // счётчик подключений 

                                // привинтить сокет на локалхост, порт 3128

     ServerSocket server = new ServerSocket(3128,  0,       

InetAddress.getByName("localhost")); 

        System.out.println("server is started"); 

          // слушаем порт          while(true) { 

// ждём нового подключения, после чего запускаем обработку клиента  в //новый вычислительный поток и увеличиваем счётчик на единичку          new SampleServer(i, server.accept()); i++; } 

} catch(Exception e) 

{System.out.println("init error: "+e);

} // вывод исключений 

} 

Интерфейс Servlet

 

package javax.servlet; import java.io.IOException;

public interface Servlet {

/*

Этот метод вызывается, чтобы проинформировать сервлет о том, что он включён как модуль для обслуживания запросов клиента. Параметр config разделяет интерфейс javax.servlet.ServletConfig, несущий информацию об окружении сервера, имени сервлета, начальных параметрах и прочих плюшках. Об интерфейсе javax.servlet.ServletConfig будет рассказано чуть далее.

*/

     public void init(ServletConfig config) throws ServletException;

/*

 Предполагается, что после вызова этой функции, сервлет аккуратно сохранит этот config у себя в переменной и будет выдавать его с помощью другого метода:

*/

     public ServletConfig getServletConfig();

Интерфейс ServletContext

/**

RequestDispatcher - это инструмент для того, чтобы переслать запрос другому ресурсу. То бишь, скажем, для того, чтобы перенаправить запрос сервлету "sample1" из тела сервлета, можно сделать

так:getServletConfig().getServletContext().getNamedDispatcher("sample1").f orward(request, response);

Собственно класс RequestDispatcher включает в себя лишь два метода: public void forward(ServletRequest request, ServletResponse response) throws ServletException,  java.io.IOException public void include(ServletRequest request,

ServletResponse response) throws ServletException, java.io.IOException  Причём первый - для перенаправления запроса, а второй - для включения результата работы вызываемого сервлета в результат работы текущего. К примеру, сервлет 1 печатает слово "test 1", потом вызывает include для сервлета два, после чего печатает слово "test 2". Сервлет 2 же просто печатает слово " and ". Результатом работы сервлета 1 будет строка "test 1 and test 2".

*/

            public RequestDispatcher getRequestDispatcher(String path);             public RequestDispatcher getNamedDispatcher(String name);

 

            

  

            public Servlet getServlet(String name) throws ServletException;             public Enumeration getServletNames(); /**

Записать что-то в лог сервера.

*/

            public void log(String msg);

            public void log(Exception exception, String msg);             public void log(String message, Throwable throwable); /**

Переводит путь типа "/index.html" в

http://host/contextPath/index.html

*/

public String getRealPath(String path); /**

Возвращает имя сервера.

*/

public String getServerInfo();

/**

Доступ к параметрам, с которыми был запущен сервер. Тут же могут лежать имя хоста, порт и прочие полезности.

*/

public String getInitParameter(String name); public Enumeration getInitParameterNames();

Интерфейс ServletContext

/**

Четыре метода для работы с аттрибутами. Роль аттрибутов выполняет любой объект любого класса. Цель данных функций - пересылать между несвязанными друг с другом сервлетами разные объекты.

*/

public Object getAttribute(String name); public Enumeration getAttributeNames(); public void setAttribute(String name, Object object); public void removeAttribute(String name);

/**

Этот метод позволяет обмениваться ServletContext между разными ресурсами одного и того же сервера.

*/

public ServletContext getContext(String uripath);

/**

Возвращает имя сервлета, которому принадлежит данный объект интерфейса ServletContext.

*/

public String getServletContextName();

}

 

Интерфейс ServletRequest

 

ic Object getAttribute(String name)  ic java.util.Enumeration

AttributeNames()  public String getCharacterEncod ic void setAttribute(String name, -   public void

ect o)                                          setCharacterEncoding(String en

ic void java.io.UnsupportedEncodingExc oveAttribute(java.lang.String name)  ic String getServerName()  public int getContentLengt

ic RequestDispatcher

public String getContentTy

RequestDispatcher(String path)                                                     

                                                                                                                   public int getServerPort(

public jString getParameter(String name)              public String

public java.util.Enumeration   getRemoteAddr()  getParameterNames()      public String

public String[] getParameterValues(String      getRemoteHost() 

name)                                                    public boolean isSecure

public java.util.Map getParameterMap()                                       

 

public ServletInputStream getInputStream() throws java.io.IOException  public java.io.BufferedReader getReader() throws java.io.IOException

 

Интерфейс ServletRequest

-        это инструмент для получения параметров HTTP запроса.

-        Этот интерфейс имеет некоторые методы, идентичные по названию и назначению с ServletContext:

-        public Object getAttribute(String name) 

-        public java.util.Enumeration getAttributeNames() 

-        public void setAttribute(String name, Object o) 

-        public void removeAttribute(java.lang.String name) 

-        public String getServerName() 

-        public RequestDispatcher getRequestDispatcher(String path)

/**

Работа с кодировкой символов в полях HTTP заголовка. Функции задают метод расшифровки CGI запросов из формы %NN в обычные символы. К примеру, какой стандарт - KOI8-R, windows-1251 или UTF-8 нужно применить для расшифровки кириллических символов.

*/

-         public String getCharacterEncoding() 

-         public void setCharacterEncoding(String env) throws java.io.UnsupportedEncodingException

/**

Читает поля "Content-Length", "Content-Type" из HTTP запроса.

*/

-           public int getContentLength() 

-           public String getContentType()

Интерфейс ServletRequest /** Порт сервера, IP адрес клиента, имя хоста клиента и является ли соединение скретным (по протоколу HTTPS) */ public int getServerPort()  public String getRemoteAddr()  public String getRemoteHost()  public boolean isSecure() /** Предпочитаемый клиентом язык документа (результат обработки поля "Accept-Language") */ public java.util.Locale getLocale()  public java.util.Enumeration getLocales()

Интерфейс ServletResponse

-           это инструмент для отправки данных клиенту.

/**

метод возвращает MIME тип кодировки (к примеру - UTF8), в которой будет выдаваться информация

*/

public java.lang.String getCharacterEncoding() 

/** язык используемый в документе (например - русский).

*/

public void setLocale(java.util.Locale loc)  public java.util.Locale getLocale() /**

Возвращает поток вывода данных для сервлета. Этот поток используется, к примеру, для вывода бинарных файлов.  

*/

public ServletOutputStream getOutputStream() throws java.io.IOException

/**

Текстовые данные можно выводить с помощью java.io.Writerhjjj

Этот метод автоматически конвертирует строки в тот charset, что указан в методе getCharacterEncoding() и getLocale().

*/

public java.io.PrintWriter getWriter() throws java.io.IOException

Интерфейс ServletResponse

/**

Этим методом устанавливается значение поля HTTP заголовка "Content-Length“ */ public void setContentLength(int len)

/**

Метод для отправки MIME типа содержимого документа. Поле HTTP заголовка "ContentType".*/

public void setContentType(String type)

/**

Дело в том, что поток вывода данных является буфферизованным. Это означает, что следующая порция данных будет выдана клиенту только после заполнения буфера. Указанные методы позволяют, соответственно, установить размер буффера отправки, получить его размер, инициализировать отправку содержимое буффера клиенту, не дожидаясь его заполнения, а так же очистить этот буффер от данных.

*/

public void setBufferSize(int size)  public int getBufferSize() 

public void flushBuffer() throws java.io.IOException  public void resetBuffer() /**

Этим методом можно получить флаг, начата ли уже отправка данных клиенту. Флаг будет положительным, если HTTP заголовок ответа был уже отправлен.*/

public boolean isCommitted()

public void reset()//Если HTTP заголовок ещё не отправлен, то этот метод "сбрасывает" HTTP заголовок к значениям "по умолчанию".

 

На базе этого класса был создан другой абстрактный класс - javax.servlet.http.HttpServlet :

 

public abstract class HttpServlet extends GenericServlet implements java.io.Serializable 

{

/**Создан этот класс был в соответствии с концепцией "ещё больше удобств для программиста" и имеет много полезных методов:*/

protected void doDelete(HttpServletRequest req, HttpServletResponse resp)

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

                 throws ServletException, java.io.IOException; protected void doHead(HttpServletRequest req, HttpServletResponse resp) throws ServletException, java.io.IOException; protected void doOptions(HttpServletRequest req, HttpServletResponse resp)                   throws ServletException, java.io.IOException;

 

 

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

 

protected void doPut(HttpServletRequest req, HttpServletResponse resp)                   throws ServletException, java.io.IOException;

 

protected void doTrace(HttpServletRequest req, HttpServletResponse resp)                   throws ServletException, java.io.IOException;

 

protected void service(HttpServletRequest req, HttpServletResponse resp) 

                 throws ServletException, java.io.IOException;

 

protected void service(ServletRequest req, ServletResponse res)                  throws ServletException, java.io.IOException;