SimpleDataSource (common 0.2.2 API)

java.lang.Object
- xyz.cofe.sql.SimpleDataSource

All Implemented Interfaces:

Wrapper, CommonDataSource, DataSource, ScnChanged<SimpleDataSource,Long>

Direct Known Subclasses:

BasicDataSource
```
public class SimpleDataSource
extends Object
implements DataSource, ScnChanged<SimpleDataSource,Long>
```
Описание соединения с СУБД

Author:

Kamnev Georgiy (nt.gocha@gmail.com)

Field Summary

Fields
Modifier and Type	Field and Description
`protected int`	`loginTimeout`
`protected PrintWriter`	`logWriter`
`protected EventMap<String,String>`	`properties`
`protected PropertyChangeSupport`	`psupport`
`protected String`	`url`

Constructor Summary

Constructors
Constructor and Description
`SimpleDataSource()`
`SimpleDataSource(SimpleDataSource sample)`
`SimpleDataSource(String url)`
`SimpleDataSource(String url, Properties props)`
`SimpleDataSource(String url, String username, String password)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`
`void`	`addScnChangedEvent(ScnChangedEvent ev)`
`Closeable`	`addScnChangedListener(ScnChanedListener listener)` Добавляет подписчика на изменения
`Closeable`	`addScnChangedListener(ScnChanedListener listener, boolean weakLink)` Добавляет подписчика на изменения
`void`	`assign(SimpleDataSource ds)`
`SimpleDataSource`	`clone()`
`void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`
`void`	`fireScnChanged(Comparable old, Comparable cur)`
`void`	`fireScnChangedEvent(ScnChangedEvent event)`
`void`	`fireScnChangedEvents()`
`Connection`	`getConnection()`
`Connection`	`getConnection(String username, String password)`
`int`	`getLoginTimeout()` Указывает таймаут (в секундах) на подключение к базе.
`PrintWriter`	`getLogWriter()`
`Logger`	`getParentLogger()`
`String`	`getPassword()` Возвращает пароль для соединения с СУБД
`PropertyChangeListener[]`	`getPropertyChangeListeners()`
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`
`ConcurrentLinkedQueue`	`getScnChangedEventQueue()`
`Set`	`getScnChangedListeners()` Возвращает активных подписчиков
`String`	`getUrl()`
`String`	`getUsername()` Указывает имя пользователя соединения
`boolean`	`hasListeners(String propertyName)`
`boolean`	`hasScnChangedListener(ScnChanedListener listener)` Проверяет что указанный подписчик имеется в списках рассылки
`boolean`	`isWrapperFor(Class<?> iface)`
`Pair`	`nextscn()`
`Pair`	`nextscn(boolean addEvent, boolean fireEvent)`
`EventMap<String,String>`	`properties()` Указывает свойства/параметры JDBC соединения
`void`	`removeAllScnChangedListeners()` Удаляет всех подписчиков
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`
`void`	`removeScnChangedListener(ScnChanedListener listener)` Удаляет подписчика от уведомлений
`Long`	`scn()` Возвращает текущий номер изменений
`void`	`scn(Runnable run)`
`void`	`setLoginTimeout(int seconds)` Указывает таймаут (в секундах) на подключение к базе.
`void`	`setLogWriter(PrintWriter out)`
`void`	`setPassword(String pswd)` Устанавливает пароль для соединения с СУБД
`void`	`setUrl(String url)`
`void`	`setUsername(String name)` Указывает имя пользователя соединения
`<T> T`	`unwrap(Class<T> iface)`

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - psupport
```
protected final transient PropertyChangeSupport psupport
```
  - url
```
protected String url
```
  - properties
```
protected EventMap<String,String> properties
```
  - loginTimeout
```
protected int loginTimeout
```
  - logWriter
```
protected transient PrintWriter logWriter
```
- Constructor Detail
  - SimpleDataSource
```
public SimpleDataSource()
```
  - SimpleDataSource
```
public SimpleDataSource(String url)
```
  - SimpleDataSource
```
public SimpleDataSource(String url,
                        String username,
                        String password)
```
  - SimpleDataSource
```
public SimpleDataSource(String url,
                        Properties props)
```
  - SimpleDataSource
```
public SimpleDataSource(SimpleDataSource sample)
```
- Method Detail
  - addPropertyChangeListener
```
public void addPropertyChangeListener(PropertyChangeListener listener)
```
  - removePropertyChangeListener
```
public void removePropertyChangeListener(PropertyChangeListener listener)
```
  - getPropertyChangeListeners
```
public PropertyChangeListener[] getPropertyChangeListeners()
```
  - addPropertyChangeListener
```
public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)
```
  - removePropertyChangeListener
```
public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener listener)
```
  - getPropertyChangeListeners
```
public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
```
  - firePropertyChange
```
public void firePropertyChange(String propertyName,
                               Object oldValue,
                               Object newValue)
```
  - hasListeners
```
public boolean hasListeners(String propertyName)
```
  - scn
```
public Long scn()
```
    Description copied from interface: ScnChanged
    
    Возвращает текущий номер изменений
    
    Specified by:
    
    scn in interface ScnChanged<SimpleDataSource,Long>
    
    Returns:
    
    текущий номер изменения
  - nextscn
```
public Pair nextscn(boolean addEvent,
                    boolean fireEvent)
```
  - nextscn
```
public Pair nextscn()
```
  - scn
```
public void scn(Runnable run)
```
  - hasScnChangedListener
```
public boolean hasScnChangedListener(ScnChanedListener listener)
```
    Description copied from interface: ScnChanged
    
    Проверяет что указанный подписчик имеется в списках рассылки
    
    Specified by:
    
    hasScnChangedListener in interface ScnChanged<SimpleDataSource,Long>
    
    Parameters:
    
    listener - подписчик
    
    Returns:
    
    true - подписчик имеется в списках рассылки
  - getScnChangedListeners
```
public Set getScnChangedListeners()
```
    Description copied from interface: ScnChanged
    
    Возвращает активных подписчиков
    
    Specified by:
    
    getScnChangedListeners in interface ScnChanged<SimpleDataSource,Long>
    
    Returns:
    
    подписчики
  - addScnChangedListener
```
public Closeable addScnChangedListener(ScnChanedListener listener)
```
    Description copied from interface: ScnChanged
    
    Добавляет подписчика на изменения
    
    Specified by:
    
    addScnChangedListener in interface ScnChanged<SimpleDataSource,Long>
    
    Parameters:
    
    listener - подписчик
    
    Returns:
    
    Интерфейс отписки от уведомлений
  - addScnChangedListener
```
public Closeable addScnChangedListener(ScnChanedListener listener,
                                       boolean weakLink)
```
    Description copied from interface: ScnChanged
    
    Добавляет подписчика на изменения
    
    Specified by:
    
    addScnChangedListener in interface ScnChanged<SimpleDataSource,Long>
    
    Parameters:
    
    listener - подписчик
    
    weakLink - true - добавить подписчика на weak ссылку / false - как hard ссылку
    
    Returns:
    
    Интерфейс отписки от уведомлений
  - removeScnChangedListener
```
public void removeScnChangedListener(ScnChanedListener listener)
```
    Description copied from interface: ScnChanged
    
    Удаляет подписчика от уведомлений
    
    Specified by:
    
    removeScnChangedListener in interface ScnChanged<SimpleDataSource,Long>
    
    Parameters:
    
    listener - подписчик
  - removeAllScnChangedListeners
```
public void removeAllScnChangedListeners()
```
    Description copied from interface: ScnChanged
    
    Удаляет всех подписчиков
    
    Specified by:
    
    removeAllScnChangedListeners in interface ScnChanged<SimpleDataSource,Long>
  - fireScnChangedEvent
```
public void fireScnChangedEvent(ScnChangedEvent event)
```
  - getScnChangedEventQueue
```
public ConcurrentLinkedQueue getScnChangedEventQueue()
```
  - addScnChangedEvent
```
public void addScnChangedEvent(ScnChangedEvent ev)
```
  - fireScnChangedEvents
```
public void fireScnChangedEvents()
```
  - fireScnChanged
```
public void fireScnChanged(Comparable old,
                           Comparable cur)
```
  - assign
```
public void assign(SimpleDataSource ds)
```
  - clone
```
public SimpleDataSource clone()
```
    Overrides:
    
    clone in class Object
  - getUrl
```
public String getUrl()
```
  - setUrl
```
public void setUrl(String url)
```
  - properties
```
public EventMap<String,String> properties()
```
    Указывает свойства/параметры JDBC соединения
    
    Returns:
    
    свойства параметры
  - getUsername
```
public String getUsername()
```
    Указывает имя пользователя соединения
    
    Returns:
    
    имя пользователя БД
  - setUsername
```
public void setUsername(String name)
```
    Указывает имя пользователя соединения
    
    Parameters:
    
    name - имя пользователя БД
  - getPassword
```
public String getPassword()
```
    Возвращает пароль для соединения с СУБД
    
    Returns:
    
    Пароль или null
  - setPassword
```
public void setPassword(String pswd)
```
    Устанавливает пароль для соединения с СУБД
    
    Parameters:
    
    pswd - Пароль или null
  - setLoginTimeout
```
public void setLoginTimeout(int seconds)
                     throws SQLException
```
    Указывает таймаут (в секундах) на подключение к базе.
    По умолчанию 60 секунд
    
    Specified by:
    
    setLoginTimeout in interface CommonDataSource
    
    Parameters:
    
    seconds - таймаут в секундах
    
    Throws:
    
    SQLException - Данная ошибка не генерируется этим методом
  - getLoginTimeout
```
public int getLoginTimeout()
                    throws SQLException
```
    Указывает таймаут (в секундах) на подключение к базе.
    По умолчанию 60 секунд
    
    Specified by:
    
    getLoginTimeout in interface CommonDataSource
    
    Returns:
    
    таймаут в секундах
    
    Throws:
    
    SQLException - Данная ошибка не генерируется этим методом
  - getLogWriter
```
public PrintWriter getLogWriter()
                         throws SQLException
```
    Specified by:
    
    getLogWriter in interface CommonDataSource
    
    Throws:
    
    SQLException
  - setLogWriter
```
public void setLogWriter(PrintWriter out)
                  throws SQLException
```
    Specified by:
    
    setLogWriter in interface CommonDataSource
    
    Throws:
    
    SQLException
  - getConnection
```
public Connection getConnection()
                         throws SQLException
```
    Specified by:
    
    getConnection in interface DataSource
    
    Throws:
    
    SQLException
  - getConnection
```
public Connection getConnection(String username,
                                String password)
                         throws SQLException
```
    Specified by:
    
    getConnection in interface DataSource
    
    Throws:
    
    SQLException
  - getParentLogger
```
public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException
```
    Specified by:
    
    getParentLogger in interface CommonDataSource
    
    Throws:
    
    SQLFeatureNotSupportedException
  - unwrap
```
public <T> T unwrap(Class<T> iface)
             throws SQLException
```
    Specified by:
    
    unwrap in interface Wrapper
    
    Throws:
    
    SQLException
  - isWrapperFor
```
public boolean isWrapperFor(Class<?> iface)
                     throws SQLException
```
    Specified by:
    
    isWrapperFor in interface Wrapper
    
    Throws:
    
    SQLException

Class SimpleDataSource

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

psupport

url

properties

loginTimeout

logWriter

Constructor Detail

SimpleDataSource

SimpleDataSource

SimpleDataSource

SimpleDataSource

SimpleDataSource

Method Detail

addPropertyChangeListener

removePropertyChangeListener

getPropertyChangeListeners

addPropertyChangeListener

removePropertyChangeListener

getPropertyChangeListeners

firePropertyChange

hasListeners

scn

nextscn

nextscn

scn

hasScnChangedListener

getScnChangedListeners

addScnChangedListener

addScnChangedListener

removeScnChangedListener

removeAllScnChangedListeners

fireScnChangedEvent

getScnChangedEventQueue

addScnChangedEvent

fireScnChangedEvents

fireScnChanged

assign

clone

getUrl

setUrl

properties

getUsername

setUsername

getPassword

setPassword

setLoginTimeout

getLoginTimeout

getLogWriter

setLogWriter

getConnection

getConnection

getParentLogger

unwrap

isWrapperFor