All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface relaaja.database.DataDefinition

public interface DataDefinition
Rajapinta tietokannan rakenteen määrittelemiseksi. Yleiskäyttöisyyden säilyttämiseksi tauluihin, sarakkeisiin yms. viitataan nimillä. Rajapinnan läpi rakenteiset tiedot välitetään DD-alkuisten olioiden tai niistä perittyjen aliluokkien välityksellä. Näin rajapintaa käyttävä luokka voi tallentaa tietoja, joihin rajapinta ei ole varautunut.

Author:
Sami Jaala, Petri Pusa

Method Index

o addColumn(String, String, DDColumnType, DDConstraintParameter)
Lisää uuden sarakkeen olemassolevaan tauluun.
o addConstraint(String, DDConstraintParameter)
Lisää rajoitteen tauluun.
o addDomain(String, DDColumnType, DDConstraintParameter)
Lisää uuden arvojoukon.
o addTable(String)
Lisää tietokantaan tyhjän taulun.
o modifyColumn(String, DDColumnType, DDConstraintParameter)
Muuttaa olemassolevan sarakkeen ominaisuuksia.
o modifyDomain(String, DDColumnType, DDConstraintParameter)
Muuttaa olemassaolevan arvojoukon ominaisuuksia.
o removeColumn(String, String)
Poistaa sarakkeen taulusta.
o removeConstraint(String)
Poistaa rajoitteen kaaviosta
o removeConstraint(String, DDConstraintParameter)
Poistaa rajoitteen taulusta
o removeDomain(String)
Poistaa arvojoukon.
o removeTable(String)
Poistaa taulun tietokannasta.
o renameTable(String, String)
Vaihtaa taulun nimeä.

Methods

o addColumn 
 public abstract void addColumn(String tableName,
                                String columnName,
                                DDColumnType column,
                                DDConstraintParameter constraint) throws ObjectDoesntExistException, InvalidObjectException, InvalidNameException, NameAlreadyExistsException
Lisää uuden sarakkeen olemassolevaan tauluun.

Parameters:
tableName - kohdetaulun nimi
columnName - saraketieto-olio
column - sarakkeen tyyppitiedot
constraint - sarakkeeseen liittyvät rajoitteet
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
o addConstraint 
 public abstract void addConstraint(String tableName,
                                    DDConstraintParameter constraint) throws NameAlreadyExistsException, InvalidObjectException
Lisää rajoitteen tauluun.

Parameters:
tableName - taulu, johon rajoite liittyy. null jos liittyy johonkin muuhun kuin tauluun.
constraint - sarakkeeseen liittyvät rajoitukset
Throws: NameAlreadyExistsException
jos samanniminen rajoite on jo olemassa
Throws: InvalidObjectException
jos constraint on vääränlainen
o addDomain 
 public abstract void addDomain(String domainName,
                                DDColumnType baseType,
                                DDConstraintParameter constraint) throws NameAlreadyExistsException, InvalidObjectException
Lisää uuden arvojoukon.

Parameters:
domainName - nimi arvojoukolle
baseType - pohjana oleva tietotyyppi
constraint - arvojoukkoon liittyvät rajoitukset
Throws: NameAlreadyExistsException
jos samanniminen arvojoukko on jo olemassa
Throws: InvalidObjectException
jos constraint tai baseType on vääränlainen
o addTable 
 public abstract void addTable(String name) throws NameAlreadyExistsException, InvalidNameException
Lisää tietokantaan tyhjän taulun.

Parameters:
name - nimi uudelle taululle.
Throws: NameAlreadyExistsException
jos samanniminen taulu on jo olemassa
Throws: InvalidNameException
jos taulun nimi ei ole sallittu
o modifyColumn 
 public abstract void modifyColumn(String tableName,
                                   DDColumnType column,
                                   DDConstraintParameter constraint) throws DatabaseException
Muuttaa olemassolevan sarakkeen ominaisuuksia.

Parameters:
tableName - kohdetaulun nimi
column - sisältää sarakkeen muuttuvat tiedot (= muut kuin nimi)
constraint - sisältää muuttuvat rajoitteet
Throws: DatabaseException
jos muuttamisessa joku meni pieleen. Mahdollisuuksia on monia.
o modifyDomain 
 public abstract void modifyDomain(String domainName,
                                   DDColumnType baseType,
                                   DDConstraintParameter constraint) throws DatabaseException
Muuttaa olemassaolevan arvojoukon ominaisuuksia.

Parameters:
domainName - arvojoukon nimi
baseType - sisältää muuttuvat tiedot
constraint - sisältää muuttuvat rajoitteet
Throws: DatabaseException
jos muuttamisessa joku meni pieleen. Mahdollisuuksia on monia.
o removeColumn 
 public abstract void removeColumn(String tableName,
                                   String columnName) throws ObjectDoesntExistException
Poistaa sarakkeen taulusta.

Parameters:
tablename - kohdetaulun nimi
columnname - poistettavan sarakkeen nimi
Throws: ObjectDoesntExistException
jos joko taulua tai saraketta ei ole olemassa.
o removeConstraint 
 public abstract void removeConstraint(String constraintName) throws ObjectDoesntExistException
Poistaa rajoitteen kaaviosta

Parameters:
constraintName - rajoitteen nimi
Throws: ObjectDoesntExistException
jos rajoitetta ei ole olemassa.
o removeConstraint 
 public abstract void removeConstraint(String tableName,
                                       DDConstraintParameter constraint) throws InvalidObjectException
Poistaa rajoitteen taulusta

Parameters:
tableName - taulun nimi, josta rajoite poistetaan
constraint - poistettavan rajoitteen tiedot
Throws: InvalidObjectException
jos constraint on vääränlainen
o removeDomain 
 public abstract void removeDomain(String domainName) throws ObjectDoesntExistException
Poistaa arvojoukon.

Parameters:
domainName - poistettavan arvojoukon nimi
Throws: ObjectDoesntExistException
jos arvojoukkoa ei ole olemassa.
o removeTable 
 public abstract void removeTable(String name) throws ObjectDoesntExistException
Poistaa taulun tietokannasta.

Parameters:
name - poistettavan taulun nimi
Throws: ObjectDoesntExistException
jos taulua ei ole olemassa
o renameTable 
 public abstract void renameTable(String oldName,
                                  String newName) throws ObjectDoesntExistException, NameAlreadyExistsException, InvalidNameException
Vaihtaa taulun nimeä.

Parameters:
oldName - vanha taulun nimi
newName - uusi nimi
Throws: ObjectDoesntExistException
jos oldName nimistä taulua ei ole olemassa
Throws: NameAlreadyExistsException
jos newName niminen taulu on jo olemassa
Throws: InvalidNameException
jos newName ei kelpaa taulun nimeksi 
All Packages  Class Hierarchy  This Package  Previous  Next  Index