concept
Interface DataStructure

public interface DataStructure

Title: DataStructure

Description: Interface to Conference Scheduler -application logig.

Copyright: Copyright (c) 2006
CONCEPT-lisenssi Tekijänoikeus (c) 2006, Pekka Kuuva, Tatu Repo, Pasi Saari, Anna Seppänen. Kaikki oikeudet pidätetään. Tämän ohjelmiston levittäminen ja käyttö lähdekoodina ja binäärinä, muutettuna tai muuttamattomana, on sallittu edellyttäen, että seuraavat ehdot täytetään: 1. OHJELMISTON LEVITTÄMINEN Lähdekoodikopioissa, dokumentaatiossa ja muussa ohjelmiston mukana tulevassa aineistossa on oltava tämä lisenssi kokonaisuudessaan. 1.2. VIENTIRAJOITUKSET Ohjelmistoa tai sen osia ei saa viedä Amerikan Yhdysvaltoihin ilman tekijöiden erillistä suostumusta. 2. OHJELMISTON KÄYTTÖ (EULA) 2.1 KÄYTTÖEHDOT Ohjelmiston käyttäjän tulee joskus suorittaa vähintään yksi seuraavista toimista: a) Tarjota omalla kustannuksellaan olut tasokkaassa ravintolassa, pubissa tai muussa vastaavassa anniskelua harjoittavassa liikkeessä kullekin tekijöistä, sekä ilmoittaa tästä tarjouksesta. b) Tarjota tekijöille omalla kustannuksellaan pääsy tapahtumaan, jonka yhteydessä sovellusta on käytetty, ja ilmoittaa tästä tarjouksesta tekijöille. Ilmoittamisella tarkoitetaan vähintään viikkoa ennen tarjouk- sen täytäntöönpanoa tekijöille lähetettyä sähköpostia, jossa ilmoitetaan ohjelmiston käyttäjän nimi ja yhteystiedot sekä tarjous ja sen ajankohta. Jos käyttöehdot eivät ole täyttyneet, ohjelmistoa ei saa käyttää. 2.1. TAKUU Tekijänoikeuden haltijat ja ohjelmiston kehittäjät tarjoavat tämän ohjelmiston "sellaisena kuin se on". Sovellukselle ei myönnetä minkäänlaista takuuta kaupallisesti hyväksyttävästä laadusta eikä sen taata soveltuvan mihinkään tarkoitukseen. 2.2. VASTUUNRAJOITUS Tekijänoikeuden haltija ja ohjelmiston kehittäjät eivät ole missään tilanteessa vastuussa suorista, epäsuorista, yleisistä, erityisistä, satunnaisista tai seurauksellisista vahingoista (sisältäen, muttei tyhjentävästi, korvaavan tuotteen tai palvelun hankinnan, käyttömahdollisuuden, tiedon tai voittojen menetykset, tai liiketoiminnan keskeytymisen), jotka aiheutuvat miten tahansa ja millä tahansa vahingonkorvausoikeudellisella perusteella mukaanlukien sopimusvastuu, ankara vastuu ja sopimuksen ulkoinen vastuu (huolimattomuus tai muu), vaikka kyseisten vahinkojen mahdollisuudesta olisi kerrottu.

Version:
1.0
Author:
AS, TR
Method Detail

getKeywords

public java.util.Vector getKeywords(concept.structure.Topic topic)
Returns keywords of topic concerned.
Parameters:
topic - Topic
Returns:
Vector, keywords

getTopics

public java.util.Vector getTopics()
Returns all topics.
Returns:
Vector, topics

getBlockTypes

public java.util.Vector getBlockTypes()
Returns all block types.
Returns:
Vector, types

getSessionAndPresentationTypes

public java.util.Vector getSessionAndPresentationTypes()
Returns all types of sessions and presentations
Returns:
Vector, types

getDayCount

public int getDayCount()
Returns number of days.
Returns:
int, number of days

getDayBegin

public long getDayBegin(int index)
Returns first millisecond of day.
Parameters:
index - int
Returns:
long, timestamp of begintime

getHalls

public java.util.Vector getHalls(int day)
Returns halls that are used in a day.
Parameters:
day - int
Returns:
Vector, halls

getBlocks

public java.util.Vector getBlocks(int day)
Returns blocks that are added in a day.
Parameters:
day - int
Returns:
Vector, blocks

getSessions

public java.util.Vector getSessions(int day)
Returns sessions that are scheduled at given day
Parameters:
day - int
Returns:
Vector, sessions

getAllHalls

public java.util.Vector getAllHalls()
Returns all halls.
Returns:
Vector, halls

getChairmenByTopic

public java.util.Vector getChairmenByTopic(concept.structure.Topic topic)
Returns chairmen who can be set as chairman (have free duties) in a session of certain topic.
Parameters:
topic - String
Returns:
Vector, chairmen

addPresentation

public java.util.Vector addPresentation(concept.structure.Session s,
                                        concept.structure.Presentation p)
Adds presentation to session (in last place).
Parameters:
s - Session
p - Presentation
Returns:
Vector, conflicts that operation caused

removePresentationFromSession

public boolean removePresentationFromSession(concept.structure.Session s,
                                             concept.structure.Presentation p)
Removes presentation from session.
Parameters:
s - Session
p - Presentation
Returns:
boolean, was operation succesfull

newSession

public concept.structure.Session newSession(java.lang.String abbrv,
                                            java.lang.String Title,
                                            concept.structure.Topic topic,
                                            concept.structure.Type type,
                                            concept.structure.Presenter cman1,
                                            concept.structure.Presenter cman2)
Creates new session with given parameters.
Parameters:
abbrv - String
Title - String
topic - Topic
type - Type
cman1 - Presenter
cman2 - Presenter
Returns:
Session, new Session

updateSessionData

public java.util.Vector updateSessionData(concept.structure.Session s,
                                          java.lang.String abbrv,
                                          java.lang.String Title,
                                          concept.structure.Topic topic,
                                          concept.structure.Type type,
                                          concept.structure.Presenter cman1,
                                          concept.structure.Presenter cman2,
                                          boolean ready)
Updates data of a session.
Parameters:
s - Session
abbrv - String
Title - String
topic - Topic
type - Type
cman1 - Presenter
cman2 - Presenter
ready - boolean
Returns:
Vector, conflicts that operation caused

scheduleSession

public java.util.Vector scheduleSession(concept.structure.Session s,
                                        concept.structure.Hall h,
                                        concept.structure.Block b)
Sets schedule data for sessions.
Parameters:
s - Session
h - Hall
b - Block
Returns:
Vector, conflicts that operation caused

swapSessions

public java.util.Vector swapSessions(concept.structure.Session s1,
                                     concept.structure.Session s2)
Switches scudule data of two sessions.
Parameters:
s1 - Session
s2 - Session
Returns:
Vector, conflicts that operation caused

removeScheduleData

public boolean removeScheduleData(concept.structure.Session s)
Removes schedule data from Session.
Parameters:
s - Session
Returns:
boolean, was operation succesful

replacePresentationInSession

public java.util.Vector replacePresentationInSession(concept.structure.Presentation p,
                                                     int newPlacement)
Changes presentation order in one session by replacing one presentation.
Parameters:
p - Presentation
newPlacement - int
Returns:
Vector, conflicts that operation caused

addBlock

public concept.structure.Block addBlock(long begin,
                                        long end,
                                        concept.structure.BlockType type)
Adds new block.
Parameters:
begin - long
end - long
type - BlockType
Returns:
Block, new Block

updateBlock

public java.util.Vector updateBlock(concept.structure.Block block,
                                    long begin,
                                    long end,
                                    concept.structure.BlockType type)
Updates data of block.
Parameters:
block - Block
begin - long
end - long
type - BlockType
Returns:
Vector, conflicts that operation caused

addHallToDay

public boolean addHallToDay(concept.structure.Hall hall,
                            long day)
Adds hall to be used in a day.
Parameters:
hall - Hall
day - long
Returns:
boolean, was operation succesful

removeBlock

public boolean removeBlock(concept.structure.Block block)
Removes block.
Parameters:
block - Block
Returns:
boolean, was operation succesful

removeHallFromDay

public boolean removeHallFromDay(concept.structure.Hall hall,
                                 long day)
Removes hall from a day.
Parameters:
hall - Hall
day - long
Returns:
boolean, was operation succesful

deleteSession

public boolean deleteSession(concept.structure.Session s)
Removes a session.
Parameters:
s - Session
Returns:
boolean, was operation succesful

searchSessions

public java.util.Vector searchSessions(java.lang.String abbrv,
                                       java.lang.String Title,
                                       concept.structure.Topic topic,
                                       concept.structure.Type type,
                                       concept.structure.Presenter cman,
                                       boolean isReady,
                                       boolean notReady,
                                       boolean hasRestrictions,
                                       boolean noRestrictions,
                                       boolean isScheduled,
                                       boolean notSceduled)
Searches sessions with given options and returns the results.
Parameters:
abbrv - String
Title - String
topic - Topic
type - Type
cman - Presenter
isReady - boolean
notReady - boolean
hasRestrictions - boolean
noRestrictions - boolean
isScheduled - boolean
notSceduled - boolean
Returns:
Vector, results

searchPresentations

public java.util.Vector searchPresentations(java.lang.String title,
                                            concept.structure.Topic topic,
                                            concept.structure.Type type,
                                            java.lang.String presenter,
                                            java.lang.String keyword1,
                                            java.lang.String keyword2,
                                            java.lang.String keyword3,
                                            int grade,
                                            boolean isRegistered,
                                            boolean notRegistered,
                                            boolean isPlaced,
                                            boolean notPlaced,
                                            boolean hasRestrictions,
                                            boolean noRestrictions)
Searches presentations with given options and returns results.
Parameters:
title - String
topic - Topic
type - Type
presenter - String
keyword1 - String
keyword2 - String
keyword3 - String
grade - int
isRegistered - boolean
notRegistered - boolean
isPlaced - boolean
notPlaced - boolean
hasRestrictions - boolean
noRestrictions - boolean
Returns:
Vector, results

detectAllConflicts

public java.util.Vector detectAllConflicts()
Returns existing conflicts
Returns:
Vector, existing conflicts