Руководство системного программиста » История » Версия 25
Rustam Usmanov, 16.02.2016 14:22
1 | 1 | Rustam Usmanov | h1. Руководство системного програмиста |
---|---|---|---|
2 | |||
3 | {{toc}} |
||
4 | |||
5 | h2. Аннотация |
||
6 | |||
7 | В данном документе приведены общие сведения о программе "Web-сервисы Руслан", ее структура. Описаны порядок настройки и проверки программы, дополнительные возможности. |
||
8 | |||
9 | h2. Общие сведения о программе |
||
10 | |||
11 | 16 | Rustam Usmanov | Программа "Web-сервисы Руслан" предназначена для обеспечения простого и удобного доступа удалённых пользователей к ресурсам АБИС "Руслан". Удалёнными пользователями могут являться любые пользователи сервера приложений "WildFly":http://wildfly.org, на базе которого функционирует программа. Ресурсами АБИС "Руслан" являются БД, поддерживаемые сервером "Руслан" и записи, содержащиеся в этих базах данных. Доступ к ресурсам заключается в выполнении над ними следующих операций: |
12 | 11 | Rustam Usmanov | * Поиск (по протоколу "SRU 2.0":http://www.loc.gov/standards/sru/sru-2-0.html) |
13 | 15 | Rustam Usmanov | * Извлечение, модификация, создание, удаление (по протоколу "WebDAV":http://tools.ietf.org/html/rfc4918) |
14 | 16 | Rustam Usmanov | * Заказ услуги (бронирование, копия) по найденному библиографическому описанию (по протоколу "NCIP v. 2.0.2":http://www.ncip.info/) |
15 | 1 | Rustam Usmanov | |
16 | 11 | Rustam Usmanov | Операции, связанные с чтением данных с ограниченным доступом и записью данных, требуют наличия соответствующих прав у пользователя, а следовательно и идентификации пользователя. Идентификация пользователя осуществляется при помощи провайдера идентификации по протоколу SAML 2.0. |
17 | 1 | Rustam Usmanov | |
18 | 11 | Rustam Usmanov | Взаимодействие с сервером "Руслан" осуществляется по протоколу Z39.50. |
19 | |||
20 | 12 | Rustam Usmanov | Ресурсы представляются в двух форматах: XML и JSON, в зависимости от предпочтений пользователя. |
21 | 1 | Rustam Usmanov | |
22 | 17 | Rustam Usmanov | Программа может функционировать на любых технических средствах под управлением сервера приложений *WildFly 8.**. Обязательным требованием для выполнения программы является возможность сетевого взаимодействия с сервером "Руслан" и с сервером *Oracle*, используемым АБИС "Руслан". |
23 | 12 | Rustam Usmanov | |
24 | 2 | Rustam Usmanov | h2. Структура программы |
25 | 1 | Rustam Usmanov | |
26 | 12 | Rustam Usmanov | Программа "Web-сервисы Руслан" состоит из следующих компонентов: |
27 | |||
28 | 14 | Rustam Usmanov | # @jrzs-ear*.ear@ - Z39.50-клиент, реализованный в виде EJB. |
29 | 12 | Rustam Usmanov | # @ridp*.war@ - провайдер идентификации. |
30 | # @rrs-web*.war@ - Web-интерфейс ресурсов АБИС "Руслан" |
||
31 | |||
32 | 19 | Rustam Usmanov | h2. Настройка программы |
33 | 1 | Rustam Usmanov | |
34 | 19 | Rustam Usmanov | h3. Установка программы |
35 | |||
36 | 16 | Rustam Usmanov | Установка программы заключается в "развёртывании компонентов программы на сервере приложений WildFly":https://docs.jboss.org/author/display/WFLY8/Application+deployment. |
37 | 1 | Rustam Usmanov | |
38 | 19 | Rustam Usmanov | h3. Настройка программы |
39 | |||
40 | 21 | Rustam Usmanov | h4. Настройка сервера приложений WildFly |
41 | |||
42 | h5. Настройка источников данных |
||
43 | |||
44 | 25 | Rustam Usmanov | Все источники данных Oracle, используемые сервером Руслан, должны быть "включены в конфигурацию сервера приложений WildFly":https://docs.jboss.org/author/display/WFLY8/DataSource+configuration. Следует обратить внимание на то, что настройка источников данных предусматривает "установку":https://docs.jboss.org/author/display/WFLY8/Application+deployment "JDBC драйвера Oracle":http://www.oracle.com/technetwork/database/features/jdbc/index-091264.html. Пример результата настройки источников данных, отражённого в конфигурационном файле сервера приложений WildFly, приведён в [[Руководство системного програмиста#Приложение 1. Конфигурационный файл сервера приложений WildFly|Приложении 1]]. |
45 | 20 | Rustam Usmanov | |
46 | 4 | Rustam Usmanov | h2. Перечень сокращений |
47 | 1 | Rustam Usmanov | |
48 | table{border:none}. |
||
49 | 18 | Rustam Usmanov | |EJB|Enterprise JavaBeans| |
50 | 1 | Rustam Usmanov | |JSON|JavaScript Object Notation| |
51 | 16 | Rustam Usmanov | |NISO|National Information Standards Organization| |
52 | |NCIP|NISO Circulation Interchange Protocol| |
||
53 | 1 | Rustam Usmanov | |XML|The Extensible Markup Language| |
54 | 19 | Rustam Usmanov | |АБИС|Автоматизированная библиотечно-информационная система| |
55 | 1 | Rustam Usmanov | |БД|База данных| |
56 | 23 | Rustam Usmanov | |
57 | h2. Приложение 1. Конфигурационный файл сервера приложений WildFly |
||
58 | |||
59 | h3. Источники данных |
||
60 | <pre><code class="xml"> |
||
61 | <subsystem xmlns="urn:jboss:domain:datasources:2.0"> |
||
62 | <datasources> |
||
63 | <datasource jta="false" jndi-name="java:jboss/datasources/ruslan" pool-name="ruslan" enabled="true" use-ccm="false"> |
||
64 | <connection-url>jdbc:oracle:thin:@oracle.test.org:1521/ORA11</connection-url> |
||
65 | <driver-class>oracle.jdbc.OracleDriver</driver-class> |
||
66 | <driver>ojdbc6.jar</driver> |
||
67 | <security> |
||
68 | <user-name>libmgr</user-name> |
||
69 | <password>libmgr_pwd</password> |
||
70 | </security> |
||
71 | <validation> |
||
72 | <validate-on-match>false</validate-on-match> |
||
73 | <background-validation>false</background-validation> |
||
74 | </validation> |
||
75 | <statement> |
||
76 | <share-prepared-statements>false</share-prepared-statements> |
||
77 | </statement> |
||
78 | </datasource> |
||
79 | <datasource jta="false" jndi-name="java:jboss/datasources/lib1" pool-name="lib1" enabled="true" use-ccm="false"> |
||
80 | <connection-url>jdbc:oracle:thin:@oracle.test.org:1521/ORA11</connection-url> |
||
81 | <driver-class>oracle.jdbc.OracleDriver</driver-class> |
||
82 | <driver>ojdbc6.jar</driver> |
||
83 | <security> |
||
84 | <user-name>lib1</user-name> |
||
85 | <password>lib1_pwd</password> |
||
86 | </security> |
||
87 | <validation> |
||
88 | <validate-on-match>false</validate-on-match> |
||
89 | <background-validation>false</background-validation> |
||
90 | </validation> |
||
91 | <statement> |
||
92 | <share-prepared-statements>false</share-prepared-statements> |
||
93 | </statement> |
||
94 | </datasource> |
||
95 | </datasources> |
||
96 | </subsystem> |
||
97 | </code></pre> |