JSTL: Шаблоны для разработки веб-приложений в java. Часть 3

Добавлено : 4 Nov 2008, 15:52

Теперь перейдем к рассмотрению методик работы с SQL-запросами в jstl. Скажу честно и прямо, этот подход ужасен (полагаю, вы все в курсе, что смешивать логику и визуализацию глупо). Хотя этими тегами я иногда пользуюсь для маленьких, секретненьких (никогда ни кому не показываемых) проектиков.

Для работы всех показанных далее тегов необходимо подключить к jsp-файлу следующую библиотеку тегов:

<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>

Итак, для всех следующих примеров мне понадобится база данных, таблица и записи в ней, сделаем это:

CREATE TABLE `tm_user` (
  `UserID` int(11) NOT NULL AUTO_INCREMENT,
  `UserName` varchar(100) DEFAULT NULL,
  `BirthDate` datetime DEFAULT NULL,
  `Sex` enum('male','female') DEFAULT NULL,
  `Comment` text,
  PRIMARY KEY (`UserID`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8

Теперь заполним ее:

INSERT INTO `tm_user` (username, birthdate, sex, comment) VALUES
  ('Jim Tapkin', '2006.1.1', 'male', 'bla-bla-bla'),
  ('Ron Baskerville', '2002.7.5', 'male', 'be-be-be'),
  ('Lenka Slonova', '2009.4.1', 'female', 'wow-wow-wow')

Доступ к подключению может быть выполнен либо путем использования через JNDI соединения либо внутри самого jstl-файла нужно объявить объект соединения. Сначала первая методика, создаю для tomcat файл Context.xml и кладу его в папку META-INF/context.xml:

<?xml version="1.0" encoding="UTF-8"?>
<Context path="/">
    <Resource name="jdbc/VeloDemoDS" auth="Container" type="javax.sql.DataSource"
              username="jim"
              password=""
              driverClassName="com.mysql.jdbc.Driver"
              url="jdbc:mysql://center/obmachine_t?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"
            />
</Context>

Теперь создаю jstl-код. В нем мне нужно будет первым шагом обратиться к JNDI и взять из нее подключение к описанному выше ресурсу. Затем я должен положить этот объект в какую-нибудь область видимости (пусть это будет pageContext). Теперь можно попробовать выполнить запрос, для этого используется два тега: либо query либо update. Полагаю, что вы догадались, когда нужно использовать первый из них, а когда – второй. Что касается текста запроса, то его можно указать (как сделал я) непосредственно как тело тега query, либо значением атрибута sql – без разницы.

<%
    InitialContext co = new InitialContext();
    pageContext.setAttribute("ds_jndi", co.lookup("java:comp/env/jdbc/VeloDemoDS"));
%>
<body>
 
<sql:query var="users" dataSource="${ds_jndi}">
    select * from tm_user
</sql:query>
 
<c:forEach items="${users.rows}" var="row">
    <c:out value="${row.UserName}"/>
</c:forEach>

Можно сделать и еще короче: здесь я вообще не обращался сам к JNDI а внутри атрибута dataSource тега непосредственно посылающего запросы к базе данных указал ее JNDI-адрес:

<sql:query var="users"  dataSource="jdbc/VeloDemoDS">
    select * from tm_user
</sql:query>

Если писать в каждом из query JNDI-адрес не слишком удобно (также не хочется вставлять в начале страницы код извлекающий из Context-а JNDI подключение), то можно сделать так:

<sql:setDataSource dataSource="jdbc/VeloDemoDS" var="velo_simple"/>
 
<sql:query var="users" dataSource="${velo_simple}">
    select * from tm_user
</sql:query>

В результате выполнения запроса у меня появилась переменная users. Однако с ней не все так просто: эта переменная играет роль контейнера для еще множества переменных (точнее полей) содержащих детальные сведения о том, что же там было отобрано с сервера.

rows – представляет собой список вида HashMap<String, Object>. В котором роль ключа играет имя поля, а значением является … значение поля.

rowsByIndex – список массивов. Т.е. каждый элемент списка – массив – представляет отдельную запись в таблице. Однако для доступа к полям нужно указать не имя поля, а его порядковый номер (отсчет начинается с 1).

columnNames – список имен полей. Например, так я распечатаю все имена отобранных полей:

<c:forEach items="${users.columnNames}" var="col">
    <c:out value="${col}"/>
</c:forEach>

rowCount – число равное количеству отобранных строк.

limitedByMaxRows – логическая переменная, признак того, что количество отобранных записей было ограничено, правда, я так и не понял чем ограничено и зачем … (ни явные команды в тексте запроса вида LIMIT “что-там-надо-ограничить”, ни дополнительные атрибуты для тега query не повлияли на эту переменную).

Последнее действия приведенного выше примера тривиально – нужно организовать цикл по списку rows, затем вывести с помощью c:out значения полей.

У тега query еще есть несколько атрибутов: scope – контекст, куда будет помещена переменная с результатом отбора данных; атрибуты maxRows и startRow служат для ограничения выборки начиная с некоторой записи и числом не более чем.

Запросы без переменных (параметров) слишком редки, чтобы разработчики jstl не предусмотрели несколько механизмов позволяющих вам использовать функциональность PreparedStatement-s. Для этого внутрь тега query кроме текста запроса необходимо поместить еще и элементы param. Каждый из них имеет атрибут value со значением, которое будет подставлено в текст запроса вместо вопросика (будьте внимательны с порядком следования параметров).

<sql:query var="users" dataSource="${ds_jndi}">
    select * from tm_user where UserID between ? and ?
    <sql:param value="${param.minID}" />
    <sql:param value="${param.maxID}" />
</sql:query>

Есть подвид тега param – dateParam. Его рекомендуют применять в случаях, когда поле, которое подставляется в текст запроса, имеет тип дата/время:

<sql:query var="users" dataSource="${ds_jndi}">
    select * from tm_user where BirthDate = ?
   <sql:dateParam value="${date}"/>
</sql:query>

Второй вид запросов – на обновление данных - выполняется с помощью тега update, правила его использования полностью идентичны приведенным выше для query (нужно указать источник данных, текст запроса, можно использовать параметры). Вот только в переменную “var” помещается не выборка записей, а количество записей, которые были подвергнуты модификации.

<sql:update var="qtyInsterted" dataSource="${ds_jndi}">
    insert into `tm_user` (username, birthdate, sex, comment) values
      ('Jim Tapkin', '2006.1.1', 'male', 'bla-bla-bla'),
      ('Ron Baskerville', '2002.7.5', 'male', 'be-be-be'),
      ('Lenka Slonova', '2009.4.1', 'female', 'wow-wow-wow')
</sql:update>
 
 
count affected records = <c:out value="${qtyInsterted}" />

Есть в jstl и поддержка работы с транзакциями (вот только управления транзакциями не хватает нашему гипотетическому дизайнеру, но раз есть, значит, будем разбираться). Транзакция представлена тегом “transaction”. Ее атрибутами является источник данных, для которого начата транзакция и уровень ее изоляции (isolation).

<sql:transaction dataSource="${ds_jndi}">
    <sql:update>
        delete from tm_user
    </sql:update>
    <sql:update>
        delee adfs adasd
    </sql:update>
</sql:transaction>

Обратите внимание на то, что внутри транзакции ни один из тегов query или update не содержит атрибута dataSource (что как раз таки очень логично).

Вторая команда внутри транзакции, очевидно, должна привести к ошибке – будет выброшено исключение. Визуально на экране браузера я вижу текст сообщения об ошибке, и выполнение дальнейшего кода jstl было прервано. Надо бы это поправить. Методы обработки исключений в jstl тривиальны. Если исключение произошло не внутри блока catch, то генерация страницы прерывается и с этим поделать ничего нельзя. В случае если потенциально опасные действия были внутри catch, то при генерации исключения объект, описывающий его, будет помещен внутрь переменной заданной с помощью атрибута var. Затем нужно с помощью if-а проверить чему равна эта переменная, и если она не равна null, то ошибка случилась.

<c:catch var="e_sql">
    <sql:transaction dataSource="${ds_jndi}">
        <sql:update>
            delete from tm_user
        </sql:update>
        <sql:update>
            delee adfs adasd
        </sql:update>
 
    </sql:transaction>
</c:catch>
 
<c:if test="${e_sql != null}">
    Произошла страшная ошибка: <c:out value="${e_sql}"/>
</c:if>

Завершу рассказ о работе с базами данных, показав второй способ конфигурирования подключения к СУБД – явно, в коде jstl указать драйвер, учетные данные для доступа:

<sql:setDataSource driver="com.mysql.jdbc.Driver" user="jim" password=""
   url="jdbc:mysql://center/obmachine_t?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"
   var="velo_local" scope="application"
/>

Теперь у нас есть объект подключения и его можно использовать точь-в-точь как полученный из jndi (в предыдущих примерах) для выполнения запросов на отбор данных или их модификацию.

Работа с форматирование, локализацией

В jstl входит набор тегов, специально предназначенный для создания локализованных приложений: представление дат, чисел в соответствии с определенными национальными настройками, также есть средства для загрузки текстовых ресурсов из Resource

Boundle.

Начнем мы с того, что подключим библиотеку тегов fmt:

<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

Самый часто используемый в этой библиотеке тег requestEncoding – установить значение кодировки входных данных, чтобы веб-сервер корректно произвел их декодирование:

<fmt:requestEncoding value="utf-8" />

Для работы с датами потребуются два тега: formatDate (выполняет преобразование даты в строку) и parseDate (на основании строки конструируется объект Date).

Единственным необходимым атрибутом является value – значение даты, которую необходимо форматировать. Если не указать значение атрибута var, то результат форматирования будет выведен на экран, а не в промежуточную переменную. Атрибут pattern задает строку форматирования.

<jsp:useBean id="beanNow" class="java.util.Date" />
<fmt:formatDate value="${beanNow}" var="s_now" pattern="yyyy.MMM.dd hh:mm:ss" />
<c:out value="${s_now}" />

А вот пример обратного преобразования: из строки в дату:

<fmt:parseDate pattern="dd.MM.yyyy" value="12.04.2001" />

Можно выполнить “тонкий тюнинг” процесса форматирования/парсинга с помощью атрибута timeZone и parseLocal (для тега parseDate). Возможно еще поместить операцию форматирования внутрь тега timeZone, тогда форматирование будет выполняться по определенным правилам:

<fmt:timeZone value="Europe/Minsk">
     <fmt:formatDate value="${beanNow}" pattern="yyyy.MMM.dd hh:mm:ss" />
 </fmt:timeZone>
 
<fmt:timeZone value="Antarctica/Casey">
    <fmt:formatDate value="${beanNow}" pattern="yyyy.MMM.dd hh:mm:ss" />
</fmt:timeZone>

Изменить локаль можно с помощью тега setLocale, например, так (к сожалению тега применяющего локаль на короткое время, подобно, timeZone нет):

<fmt:setLocale value="ja_JP"/>
<fmt:formatDate value="${beanNow}" pattern="yyyy.MMM.dd hh:mm:ss" />

Для работы с числами используются два тега с очень похожими на своих “братцев”: названиями: formatNumber и parseNumber:

Сначала из числа в строку:

<fmt:formatNumber pattern="#,##0.0#" value="234234.23423" />

А теперь наоборот:

<fmt:parseNumber value="234,234.23" pattern="#,##0.0#" />

Для работы с локализованными сообщениями используется два тега в паре: setBundle и message. Первый из них загружает Resource Bundle, второй – выводит сообщения на основании Resource Bundle (обратите внимание, что я при загрузке ресурсов указал название “упаковки сообщений” и именно на это имя, loc, я ссылался при выводе сообщений). У тега message обязательно должен быть указан атрибут key – это имя свойства хранящего сообщение на нужном языке. Если не указан атрибут var, то сообщение будет выведено на экран тут же, в противном случае сообщение будет помещено в промежуточную переменную.

<fmt:setBundle basename="testi.messages" var="loc" />
 
<fmt:message bundle="${loc}" key="MSG_1" />
 
<fmt:message bundle="${loc}" key="MSG_2"  var="m_2"/>
<c:out value="${m_2}" />

Вот вкратце и все теги, которые входят в состав jstl. Однако я продолжаю свой рассказ, т.к. необходимо рассказать еще и об функциях которые можно использовать при записи jstl-выражений. Во всех примерах выше я использовал синтаксис ${что-то-там}. В основном я обращался к переменным, несколько раз делал простые проверки равна переменная чему-то или не равна, проверял может значение переменной null (хотя в примерах и не было это показано, но возможно использовать в EL-выражении и тернарный оператор). Но это еще не все: если я подключу в заголовке файла jsp еще одну библиотеку, то возможности EL становятся шире (хотел, было написать в разы, но все же заменю нейтральным “становятся больше”).

<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn" %>

Начнем разбирать функции по порядку. Первая из них “fn:contains” (имена всех функций должны предваряться префиксом “fn:” – именно его мы подключили в начале jsp-файла). Contains служит для проверки того, что внутри строки содержится другая подстрока.

<c:set value="boy goes to school" var="boy" />
 
<c:if test="${fn:contains(boy, 'goes')}">
    <h1>
        He goes to School. Realy.
    </h1>
</c:if>

Если проверить такое условие нужно без учета регистра символов, то используйте функцию containsIgnoreCase:

<c:if test="${fn:containsIgnoreCase(boy, 'GOES')}">
    <h1>
        He goes to School. Realy.
    </h1>
</c:if>

Для проверки того, начинается ли некоторая строка с заданной подстроки, используйте функцию startsWith. Очевидно, что функция endsWith служит для сходной цели, но проверяет то, что строка должна заканчиваться определенными символами:

<c:if test="${fn:startsWith(boy, 'boy')}">
    <h1>
        Starts from BOY
    </h1>
</c:if>
 
<c:if test="${fn:endsWith(boy, 'school')}">
    <h1>
        Ends with SCHOOL
    </h1>
</c:if>

Для экранирования спец.символов некоторой строки перед выводом можно использовать функцию escapeXml (не забывайте, что в старом-добром c:out есть атрибут обеспечивающий сходную функциональность):

<c:set value="boy goes &copy; to school" var="boy" />
<c:out value="${boy}" />
<c:out value="${fn:escapeXml(boy)}" />
<c:out value="${boy}" escapeXml="true" />

Для анализа строки есть целая пачка функций. Начнем с того что найдем в строке позицию, с которой начинается другая строка:

<c:set value="boy goes to school" var="boy" />
<c:out value="${fn:indexOf(boy, 'to' )}" />

Теперь вырежем из исходной строки ее часть, начиная с той позиции где началось слово “to”:

<c:set value="boy goes to school" var="boy" />
<c:out value="${fn:substring(boy, fn:indexOf(boy, 'to' ), 100)}" />

Как видите, мы указываем, откуда вырезать фрагмент, третьим параметром функции выступает число – до какого символа нужно вырезать фрагмент. В следующем примере я вырезаю только два символа из строки:

<c:out value="${fn:substring(boy, fn:indexOf(boy, 'to' ), fn:indexOf(boy, 'to' )+2)}" />

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

<c:out value="${fn:substring(boy, fn:indexOf(boy, 'to' ), -1)}" />

Сразу же пока я не забыл, расскажу, как вычислить длину строки. Для этого приходится функция length. Надо сказать что length – универсальная функция и умеет считать длину не только строки, но произвольной коллекции:

<sql:query var="users"  dataSource="jdbc/VeloDemoDS">
    select * from tm_user
</sql:query>
 
<c:set value="boy goes to school" var="boy" />

Вот пример длины строки:

<c:out value="${fn:length(boy)}" />

А так считаем длину списка записей (сколько записей было отобрано из таблицы)

<c:out value="${fn:length(users.rows)}" />

Для работы со строками, когда вам нужно вырезать из них фрагменты наверняка пригодятся две парные функции: substringAfter и substringBefore. Обоим из них нужно указать как параметр строку, из которой вырезается фрагмент и строку-маркер. В первом случае будет вырезано все до заданной подстроки-маркера, во второй случае – все после нее.

<c:set value="boy goes to school" var="boy" />
After:<c:out value="${fn:substringAfter(boy, 'to')}" />
Before:<c:out value="${fn:substringBefore(boy, 'to')}" />

Преобразование в верхний и нижний регистр может быть выполнено с помощью функций toLowerCase и toUpperCase:

<c:set value="boy goes to school" var="boy" />

Делаем маленький регистр:

<c:out value="${fn:toLowerCase(boy)}" />

А теперь большой:

<c:out value="${fn:toUpperCase(boy)}" />

Для удаления символов пробелов размещенных по обоим краям строки используйте функцию trim:

<c:set value="  boy goes to school   " var="boy" />
<h1><c:out value="${fn:trim(boy)}"/></h1>

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

<c:set value="boy goes to school" var="boy" />
<c:out value="${fn:replace(boy, 'school', 'bar')}"/>

Последние функции, про которые я сегодня расскажу: split и join. Они занимаются сходными задачами – преобразованием строки в массив подстрок (split) и обратной операцией склейкой массива строк в одну большую строку. В первом и втором случае нужно указать параметр “разделитель”:

<c:set value="1,2,3,4" var="str_digits" />
 
<c:set value="${fn:split(str_digits, ',')}" var="arr_digits" />
<c:set value="${fn:join(arr_digits, '!')}"  var="str2_digits"/>

Массив подстрок – он, правда, будет неудобочитаемым:

<c:out value="${fn:length(arr_digits)}" />

А теперь обратное преобразование:

<c:out value="${str2_digits}" />

Источник — http://black-zorro.com/mediawiki/JSTL:_Шаблоны_для_разработки_веб-приложений_в_java._Часть_3