Проект

Общее

Профиль

Руководство системного программиста » История » Версия 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>