All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class relaaja.database.Schema

java.lang.Object
   |
   +----java.util.Observable
           |
           +----relaaja.database.DatabaseObservable
                   |
                   +----relaaja.database.Schema

public class Schema

extends DatabaseObservable

implements DataDefinition, Serializable, Exportable

Schema hoitaa tietokannan rakenteen muokkaukset. Tiedot rakenteessa tapahtuvista muutoksista se saa DataDefinition-rajapintaa käyttäen relaajan tapauksessa SQL-jäsentäjältä. Jäsentäjän sijaan tiedot voisivat tulla esim. DataDefinition-rajapinnan tuntevalta oliolta, joka lukee tiedot suoraan tietokannasta.

Schema sisältää metodit tietokannan rakenteen tutkimista varten. Luokka sisältää myös metodit tietokannan kuvaamiseksi SQL-kannanmäärityslauseilla sekä tiedostonimen käyttämiseksi.

Observer rajapinnan toteuttava olio voi kuunnella muutoksia Schemassa.

Author:

Petri Pusa

constraintReader

Olio tietokannassa olevien rajoitteiden tutkimiseen.

constraintVector

Tietokannassa olevat rajoitteet.

domainReader

Olio arvojoukkojen tutkimiseen.

domainVector

Tietokannassa olevat arvojoukot.

tableReader

Olio tietokannassa olevien taulujen tutkimiseen.

tableVector

Tietokannassa olevat taulut.

Schema()

Kaavion konstruktori.

addColumn(String, String, DDDataType, DDConstraintParameter)

addColumn(Table, Column)

Lisää sarakkeen tauluun.

addConstraint(String, DDConstraintParameter)

addDomain(String, DDDataType, DDConstraintParameter)

addDomainConstraint(Domain, DDConstraintParameter)

Lisää arvojoukkorajoitteen.

addDomainConstraint(String, DDConstraintParameter)

addKeyConstraint(Table, DDConstraintParameter)

Lisää avainrajoitteen taululle.

addNotNullConstraint(Table, DDNotNullParameter)

Lisää NOT NULL rajoitteen sarakkeeseen

addReferenceConstraint(Table, DDReferenceParameter)

Lisää viiteyhteyden kaavioon

addTable(String, DDTableParameter)

addUnknownConstraint(Table, DDConstraintParameter)

Lisää tuntemattoman rajoitteen

exportSQL(OutputStream)

Tallentaa SQL-lauseet, joilla tietokanta voidaan luoda.

exportSQL(String)

Tallentaa nimettyyn tiedostoon SQL-lauseet, joilla tietokanta voidaan luoda.

exportVector(OutputStream, VectorReader, Object, String)

Tallentaa SQL-lauseet VectorReaderin sisältämistä olioista.

getConstraint(String)

Palauttaa rajoitteen nimen perusteella

getConstraints()

Palauttaa VectorReader:in kaavion rajoitteisiin.

getDomain(String)

Palauttaa arvojoukon

getDomains()

Palauttaa VectorReader:in kaavion arvojoukkoihin.

getNotNullConstraint(String, DDNotNullParameter)

Palauttaa not null rajoitteen

getPrimaryKeyConstraint(String, DDPrimaryKeyParameter)

Palauttaa pääavainrajoitteen

getReferenceConstraint(String, DDReferenceParameter)

Palauttaa viiterajoitteen

getTable(String)

Palauttaa taulun nimen perusteella.

getTables()

Palauttaa VectorReader:in kaavion tauluihin.

getUniqueKeyConstraint(String, DDUniqueKeyParameter)

Palauttaa UNIQUE avain rajoitteen.

modifyColumn(String, String, DDDataType, DDConstraintParameter, int)

modifyDomain(String, DDDataType, DDConstraintParameter, int)

removeColumn(String, String)

removeColumn(Table, Column)

Poistaa sarakkeen taulusta.

removeConstraint(Constraint)

Poistaa rajoitteen kaaviosta.

removeConstraint(String)

removeConstraint(String, DDConstraintParameter)

removeConstraintVector(VectorReader)

Kutsuu VectorReaderin sisältämien rajoitteiden poisto-metodia.

removeDomain(Domain)

removeDomain(String)

removeFromConstraintList(Constraint)

removeTable(String)

removeTable(Table)

Poistaa taulun kaaviosta.

renameTable(String, String)

 private Vector constraintVector

Tietokannassa olevat rajoitteet.

 private VectorReader constraintReader

Olio tietokannassa olevien rajoitteiden tutkimiseen.

 private Vector domainVector

Tietokannassa olevat arvojoukot.

 private VectorReader domainReader

Olio arvojoukkojen tutkimiseen.

 private Vector tableVector

Tietokannassa olevat taulut.

 private VectorReader tableReader

Olio tietokannassa olevien taulujen tutkimiseen.

 public Schema()

Kaavion konstruktori.

 public void addColumn(String tableName,
                       String columnName,
                       DDDataType columnType,
                       DDConstraintParameter constraint) throws ObjectDoesntExistException, InvalidObjectException, InvalidNameException, NameAlreadyExistsException

 public void addColumn(Table table,
                       Column column) throws ObjectDoesntExistException, InvalidObjectException, InvalidNameException, NameAlreadyExistsException

Lisää sarakkeen tauluun.

Parameters:

table - taulu, johon lisätään

column - lisättävä sarake

Throws: ObjectDoesntExistException

jos taulua tai saraketta ei ole olemassa

Throws: InvalidObjectException

jos column tai constraint on vääränlainen.

Throws: InvalidNameException

jos columnName ei ole sallittu nimenä.

Throws: NameAlreadyExistsException

jos taululla on jo samanniminen sarake

 public void addConstraint(String tableName,
                           DDConstraintParameter parameter) throws NameAlreadyExistsException, InvalidObjectException

 public void addDomain(String name,
                       DDDataType baseType,
                       DDConstraintParameter constraint) throws NameAlreadyExistsException, InvalidObjectException

 public void addDomainConstraint(String domainName,
                                 DDConstraintParameter constraint) throws NameAlreadyExistsException, InvalidObjectException, ObjectDoesntExistException

 DomainConstraint addDomainConstraint(Domain domain,
                                      DDConstraintParameter parameter) throws InvalidObjectException

Lisää arvojoukkorajoitteen.

Parameters:

domain - arvojoukko, johon rajoite lisätään.

parameter - rajoitteen tiedot

Returns:

lisätty rajoite

Throws: InvalidObjectException

jos lisääminen ei onnistu

 private KeyConstraint addKeyConstraint(Table table,
                                        DDConstraintParameter parameter) throws InvalidObjectException

Lisää avainrajoitteen taululle.

Parameters:

tableName - taulu, johon rajoite lisätään.

constraint - avain rajoite

Throws: InvalidObjectException

jos parameter ei ole kelvollinen tai taulua ei ole olemassa.

 private NotNullConstraint addNotNullConstraint(Table table,
                                                DDNotNullParameter parameter) throws ObjectDoesntExistException, InvalidObjectException

Lisää NOT NULL rajoitteen sarakkeeseen

Parameters:

table - taulu, johon rajoite lisätään

parameter - rajoitteen tiedot

Throws: ObjectDoesntExistException

jos taulua tai saraketta ei ole olemassa

Throws: InvalidObjectException

jos joku tieto oli vääränlainen

 private ReferenceConstraint addReferenceConstraint(Table table,
                                                    DDReferenceParameter parameter) throws InvalidObjectException, ObjectDoesntExistException

Lisää viiteyhteyden kaavioon

Parameters:

table - taulu, josta yhteys lähtee.

parameter - yhteyteen liittyvät parametrit.

Throws: InvalidObjectException

jos taulu tai parametri ei kelpaa.

Throws: ObjectDoesntExistException

jos viitettä yritetään tehdä tauluun tai sarakkeeseen, jota ei ole olemassa.

 public void addTable(String tableName,
                      DDTableParameter parameter) throws NameAlreadyExistsException, InvalidNameException

 TableConstraint addUnknownConstraint(Table table,
                                      DDConstraintParameter parameter) throws InvalidObjectException

Lisää tuntemattoman rajoitteen

Parameters:

table - taulu, johon rajoite liittyy

parameter - rajoitteen tiedot

Throws: InvalidObjectException

jos rajoitteen lisäys epäonnistuu

 public void exportSQL(String filename) throws IOException

Tallentaa nimettyyn tiedostoon SQL-lauseet, joilla tietokanta voidaan luoda.

Parameters:

filename - tiedosto, jonne SQL-lauseet tallennetaan.

Throws: IOException

jos tallentaminen epäonnistui

 public void exportSQL(OutputStream stream) throws IOException

Tallentaa SQL-lauseet, joilla tietokanta voidaan luoda.

Parameters:

stream - virta, jonne SQL-lauseet tallennetaan

Throws: IOException

jos tallentaminen epäonnistui

 void exportVector(OutputStream stream,
                   VectorReader reader,
                   Object exporter,
                   String separator) throws IOException

Tallentaa SQL-lauseet VectorReaderin sisältämistä olioista. Rajoitteista tallennetaan vain ne, jotka liittyvät suoraan metodin kutsuneeseen olioon.

Parameters:

stream - virta, jonne lauseet tallennetaan

reader - tallennettavat oliot

exporter - olio, jonka exportSQL() metodia ollaan suorittamassa eli yleensä this

Throws: IOException

jos tallentaminen epäonnistui

 public Constraint getConstraint(String name) throws ObjectDoesntExistException

Palauttaa rajoitteen nimen perusteella

Parameters:

name - rajoitteen nimi

Returns:

rajoite

Throws: ObjectDoesntExistException

jos rajoitetta ei löytynyt

 public VectorReader getConstraints()

Palauttaa VectorReader:in kaavion rajoitteisiin. VectorReaderin alkiot ovat tyyppiä Constraint.

Returns:

kaavion rajoitteet

See Also:

Constraint

 public VectorReader getDomains()

Palauttaa VectorReader:in kaavion arvojoukkoihin. VectorReaderin alkiot ovat tyyppiä Domain.

Returns:

kaavion arvojoukot

See Also:

Domain

 private NotNullConstraint getNotNullConstraint(String tableName,
                                                DDNotNullParameter parameter) throws InvalidObjectException, ObjectDoesntExistException

Palauttaa not null rajoitteen

Parameters:

tableName - taulu, johon rajoite kuuluu

parameter - rajoitteeseen liittyvät tiedot

Returns:

not null rajoite

 private KeyConstraint getPrimaryKeyConstraint(String tableName,
                                               DDPrimaryKeyParameter parameter) throws InvalidObjectException, ObjectDoesntExistException

Palauttaa pääavainrajoitteen

Parameters:

tableName - taulu, johon rajoite kuuluu

parameter - rajoitteeseen liittyvät tiedot

Returns:

pääavainrajoite

 public Domain getDomain(String domainName) throws ObjectDoesntExistException

Palauttaa arvojoukon

Parameters:

domainName - arvojoukon nimi

Throws: ObjectDoesntExistException

jos halutunnimistä arvojoukkoa ei ole olemassa

 private ReferenceConstraint getReferenceConstraint(String tableName,
                                                    DDReferenceParameter parameter) throws InvalidObjectException, ObjectDoesntExistException

Palauttaa viiterajoitteen

Parameters:

tableName - taulu, johon rajoite kuuluu

parameter - rajoitteeseen liittyvät tiedot

Returns:

viiterajoite

 public Table getTable(String name) throws ObjectDoesntExistException

Palauttaa taulun nimen perusteella.

Parameters:

name - taulun nimi

Returns:

taulu

Throws: ObjectDoesntExistException

jos taulua ei ole olemassa

 public VectorReader getTables()

Palauttaa VectorReader:in kaavion tauluihin. VectorReaderin alkiot ovat tyyppiä Table.

Returns:

kaavion taulut

See Also:

Table

 private KeyConstraint getUniqueKeyConstraint(String tableName,
                                              DDUniqueKeyParameter parameter) throws ObjectDoesntExistException

Palauttaa UNIQUE avain rajoitteen. Oikea rajoite on:

• luokkana KeyConstraint
• getKeyType() == KeyConstraint.UNIQUE_KEY
• sisältää parametrissa määritellyt sarakkeet
• sisältää yhtä monta (ei yhtään enempää!) saraketta kuin parametrissa

 public void modifyColumn(String tableName,
                          String columnName,
                          DDDataType dataType,
                          DDConstraintParameter constraint,
                          int modification) throws DatabaseException

 public void modifyDomain(String domainName,
                          DDDataType baseType,
                          DDConstraintParameter constraint,
                          int modification) throws DatabaseException

 public void removeColumn(String tableName,
                          String columnName) throws ObjectDoesntExistException, InvalidObjectException

 public void removeColumn(Table table,
                          Column column) throws ObjectDoesntExistException, InvalidObjectException

Poistaa sarakkeen taulusta.

Parameters:

table - taulu, josta sarake poistetaan

column - poistettava sarake

Throws: ObjectDoesntExistException

jos taulua tai saraketta ei ole olemassa

Throws: InvalidObjectException

jos parameterit ovat muuten virheellisiä

 public void removeConstraint(Constraint constraint) throws DatabaseException

Poistaa rajoitteen kaaviosta.

Parameters:

constraint - poistettava rajoite

Throws: DatabaseException

jos saraketta ei voida poistaa

 public void removeConstraint(String constraintName) throws DatabaseException

 public void removeConstraint(String tableName,
                              DDConstraintParameter constraint) throws InvalidObjectException, ObjectDoesntExistException

 void removeConstraintVector(VectorReader reader) throws DatabaseException

Kutsuu VectorReaderin sisältämien rajoitteiden poisto-metodia.

Parameters:

reader - rajoiteet

Throws: DatabaseException

jos rajoitteiden poistaminen ei onnistunut

 public void removeDomain(Domain domain) throws DatabaseException

 public void removeDomain(String name) throws DatabaseException

 void removeFromConstraintList(Constraint constraint)

 public void removeTable(Table table) throws ObjectDoesntExistException, InvalidObjectException

Poistaa taulun kaaviosta.

Parameters:

table - poistettava taulu

Throws: ObjectDoesntExistException

jos taulua ei ole olemassa

Throws: InvalidObjectException

jos taulu on muuten vääränlainen

 public void removeTable(String name) throws ObjectDoesntExistException, InvalidObjectException

 public void renameTable(String oldName,
                         String newName) throws ObjectDoesntExistException, NameAlreadyExistsException, InvalidNameException

All Packages  Class Hierarchy  This Package  Previous  Next  Index