Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

Commit 6ff59b6

Browse files
Add class and interface doc files
1 parent a2fd5f8 commit 6ff59b6

15 files changed

+4134
-0
lines changed

‎Doc/Class_Class.txt‎

Lines changed: 264 additions & 0 deletions
Large diffs are not rendered by default.

‎Doc/Collector_Interface.txt‎

Lines changed: 221 additions & 0 deletions
Large diffs are not rendered by default.

‎Doc/Collectors_Class.txt‎

Lines changed: 221 additions & 0 deletions
Large diffs are not rendered by default.

‎Doc/Connection_Interface.txt‎

Lines changed: 264 additions & 0 deletions
Large diffs are not rendered by default.

‎Doc/DatabaseMetaData_Interface.txt‎

Lines changed: 577 additions & 0 deletions
Large diffs are not rendered by default.

‎Doc/DriverManager.txt‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
****** Class DriverManager ******
2+
3+
public class DriverManager extends Object
4+
5+
Базовая служба для управления набором драйверов JDBC.
6+
7+
ПРИМЕЧАНИЕ. Интерфейс DataSource, новый в JDBC 2.0 API, предоставляет
8+
еще один способ подключения к источнику данных. Использование объекта
9+
DataSource является предпочтительным способом подключения к источнику
10+
данных.
11+
12+
В рамках своей инициализации класс DriverManager попытается загрузить
13+
классы драйверов, указанные в системном свойстве jdbc.drivers. Это
14+
позволяет пользователю настраивать драйверы JDBC, используемые их
15+
приложениями.
16+
17+
Например, в вашем файле ~/.hotjava/properties вы можете указать:
18+
19+
jdbc.drivers=foo.bah.Driver:wombat.sql.Driver:bad.taste.ourDriver
20+
21+
Методы DriverManager getConnection и getDrivers были улучшены для поддержки
22+
механизма поставщика услуг Java Standard Edition. Драйверы JDBC 4.0 должны
23+
включать файл META-INF/services/java.sql.Driver. Этот файл содержит имя
24+
реализации JDBC-драйверов java.sql.Driver.
25+
26+
Например, чтобы загрузить класс my.sql.Driver, файл
27+
META-INF/services/java.sql.Driver должен содержать
28+
запись: my.sql.Driver
29+
30+
Приложениям больше не нужно явно загружать драйверы JDBC с помощью
31+
Class.forName(). Существующие программы, которые в настоящее время
32+
загружают драйверы JDBC с помощью Class.forName(), будут продолжать
33+
работать без изменений.
34+
35+
При вызове метода getConnection DriverManager попытается найти подходящий
36+
драйвер среди тех, которые загружаются при инициализации, и тех, которые
37+
загружаются явно с использованием того же загрузчика классов, что и текущий
38+
апплет или приложение.
39+
40+
Начиная с Java 2 SDK, Standard Edition, версии 1.3, поток ведения журнала
41+
можно задать только в том случае, если было предоставлено соответствующее
42+
разрешение. Обычно это делается с помощью инструмента PolicyTool, который
43+
можно использовать для предоставления разрешения java.sql.SQLPermission
44+
"setLog".
45+
46+
****** Методы ******
47+
48+
static void deregisterDriver(Driver driver) - Удаляет указанный драйвер из списка
49+
зарегистрированных драйверов DriverManager.
50+
51+
static Connection getConnection(String url) - Пытается установить соединение с заданным
52+
URL-адресом базы данных.
53+
54+
static Connection getConnection(String url,
55+
Properties info) - Пытается установить соединение с заданным
56+
URL-адресом базы данных.
57+
58+
static Connection getConnection(String url,
59+
String user,
60+
String password) - Пытается установить соединение с заданным
61+
URL-адресом базы данных.
62+
63+
static Driver getDriver(String url) - Пытается найти драйвер, который понимает данный URL-адрес.
64+
65+
static Enumeration<Driver> getDrivers() - Извлекает перечисление со всеми загруженными в данный
66+
момент драйверами JDBC, к которым у текущего вызывающего
67+
объекта есть доступ.
68+
69+
static int getLoginTimeout() - Получает максимальное время в секундах, которое драйвер может ждать
70+
при попытке входа в базу данных.
71+
72+
static PrintStream getLogStream() - Устарело - не рекомендуется к использованию.
73+
Используйте getLogWriter
74+
75+
static PrintWriter getLogWriter() - Получает средство записи журнала.
76+
77+
static void println(String message) - Печатает сообщение в текущий поток журнала JDBC.
78+
79+
static void registerDriver(Driver driver) - Регистрирует данный драйвер в DriverManager.
80+
81+
static void registerDriver(Driver driver, DriverAction da) - Регистрирует данный драйвер
82+
в DriverManager.
83+
84+
static void setLoginTimeout(int seconds) - Устанавливает максимальное время в секундах,
85+
которое драйвер будет ожидать при попытке
86+
подключения к базе данных после идентификации
87+
драйвера.
88+
89+
static void setLogStream(PrintStream out) - Устарело - не рекомендуется к использованию.
90+
Используйте setLogWriter
91+
92+
static void setLogWriter(PrintWriter out) - Задает объект PrintWriter для регистрации и
93+
отслеживания, который используется DriverManager
94+
и всеми драйверами.
95+
96+
См. полную документацию (ENG):
97+
https://docs.oracle.com/javase/8/docs/api/java/sql/DriverManager.html

‎Doc/Driver_Interface.txt‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
****** Interface Driver ******
2+
3+
public interface Driver
4+
5+
Интерфейс, который должен реализовать каждый класс драйвера. Платформа
6+
Java SQL позволяет использовать несколько драйверов баз данных.
7+
8+
Каждый драйвер должен предоставлять класс, реализующий интерфейс Driver.
9+
10+
DriverManager попытается загрузить столько драйверов, сколько сможет найти,
11+
а затем для любого заданного запроса на подключение он по очереди попросит
12+
каждый драйвер попытаться подключиться к целевому URL-адресу.
13+
14+
Настоятельно рекомендуется, чтобы каждый класс Driver был небольшим и
15+
автономным, чтобы класс Driver можно было загружать и запрашивать без
16+
добавления большого количества вспомогательного кода.
17+
18+
Когда класс Driver загружается, он должен создать свой экземпляр и
19+
зарегистрировать его в DriverManager. Это означает, что пользователь
20+
может загрузить и зарегистрировать драйвер, вызвав:
21+
22+
Class.forName("foo.bah.Driver")
23+
24+
Драйвер JDBC может создать реализацию DriverAction для получения
25+
уведомлений при вызове DriverManager.deregisterDriver(java.sql.Driver).
26+
27+
****** Методы ******
28+
29+
boolean acceptsURL(String url) - возвращает, может ли драйвер открыть
30+
соединение с данным URL-адресом.
31+
32+
Connection connect(String url, Properties info) - Пытается установить соединение
33+
с базой данных по указанному
34+
URL-адресу.
35+
36+
int getMajorVersion() - Получает основной номер версии драйвера.
37+
38+
int getMinorVersion() - Получает дополнительный номер версии драйвера.
39+
40+
Logger getParentLogger() - Возвращает родительский регистратор всех
41+
регистраторов, используемых этим драйвером.
42+
43+
DriverPropertyInfo[] getPropertyInfo(String url, Properties info) -
44+
Получает информацию о возможных свойствах этого драйвера.
45+
46+
boolean jdbcCompliant() - Сообщает, является ли этот драйвер подлинным драйвером
47+
JDBC CompliantTM.
48+
49+
См. полную документацию (ENG):
50+
https://docs.oracle.com/javase/7/docs/api/java/sql/Driver.html

‎Doc/InvocationHandler_Interface.txt‎

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
****** Interface InvocationHandler ******
2+
3+
Пакеты, библиотеки и классы: java.lang.reflect
4+
5+
public interface InvocationHandler
6+
7+
Все известные классы реализации: CompositeDataInvocationHandler,
8+
EventHandler,
9+
MBeanServerInvocationHandler,
10+
RemoteObjectInvocationHandler
11+
12+
InvocationHandler — это интерфейс, реализованный обработчиком
13+
вызова экземпляра прокси. Каждый экземпляр прокси имеет связанный
14+
с ним обработчик вызова. Когда метод вызывается в экземпляре
15+
прокси, вызов метода кодируется и отправляется методу вызова его
16+
обработчика вызова.
17+
18+
****** Метод ******
19+
20+
Object invoke(Object proxy,
21+
Method method,
22+
Object[] args) - Обрабатывает вызов метода на экземпляре
23+
прокси и возвращает результат. Этот метод
24+
будет вызываться в обработчике вызовов,
25+
когда метод вызывается в экземпляре прокси,
26+
с которым он связан.
27+
28+
Параметры:
29+
- proxy - экземпляр прокси, на котором был вызван метод.
30+
- method - экземпляр Method, соответствующий методу интерфейса, вызываемому
31+
на экземпляре прокси. Класс объявления объекта Method будет интерфейсом,
32+
в котором был объявлен метод, который может быть суперинтерфейсом
33+
прокси-интерфейса, через который прокси-класс наследует метод.
34+
- args - массив объектов, содержащих значения аргументов, переданных при вызове
35+
метода на экземпляре прокси, или null, если интерфейсный метод не
36+
принимает аргументов. Аргументы примитивных типов упаковываются в
37+
экземпляры соответствующего примитивного класса-оболочки, например
38+
java.lang.Integer или java.lang.Boolean.
39+
40+
Возвращает:
41+
Значение, возвращаемое при вызове метода на экземпляре прокси. Если объявленный
42+
возвращаемый тип метода интерфейса является типом-примитивом, то значение,
43+
возвращаемое этим методом, должно быть экземпляром соответствующего
44+
класса-оболочки-примитива; в противном случае это должен быть тип, присваиваемый
45+
объявленному возвращаемому типу.
46+
47+
Если значение, возвращаемое этим методом, равно null, а тип возвращаемого значения
48+
метода интерфейса является примитивным, то при вызове метода на экземпляре прокси
49+
будет сгенерировано исключение NullPointerException.
50+
51+
Если значение, возвращаемое этим методом, несовместимо с объявленным типом возвращаемого
52+
значения метода интерфейса, как описано выше, при вызове метода на экземпляре прокси
53+
будет сгенерировано исключение ClassCastException.
54+
55+
Исключения:
56+
Throwable — исключение, которое выбрасывается при вызове метода на экземпляре прокси.
57+
Тип исключения должен быть присваиваемым либо любому из типов исключений, объявленных
58+
в предложении throws метода интерфейса, либо непроверяемым типам исключений
59+
java.lang.RuntimeException или java.lang.Error.
60+
61+
Если этим методом создается проверенное исключение, которое не может быть назначено ни
62+
одному из типов исключений, объявленных в предложении throws метода интерфейса, то
63+
UndeclaredThrowableException, содержащее исключение, которое было сгенерировано этим
64+
методом, будет вызвано вызовом метода на экземпляр прокси.

0 commit comments

Comments
(0)

AltStyle によって変換されたページ (->オリジナル) /