pl.koder95.eme.core

Class AbstractFilingCabinet

java.lang.Object

pl.koder95.eme.core.AbstractFilingCabinet

All Implemented Interfaces:

FilingCabinet

Direct Known Subclasses:

TreeFilingCabinet

public class AbstractFilingCabinet
extends Object
implements FilingCabinet

Ogólna szafa aktowa jest implementacją dostarczającą ogólny kształt szafy, który bazuje na interfejsach mapy i wytwórcy map. Dostarcza również implementację metody getPersonalData(), która korzysta ze statycznej metody createPersonalData(AbstractFilingCabinet, Map, NameSetFactory) podczas tworzenia danych osobowych.

Mapa szafy aktowej - opis mapowania

Mapa szafy wiąże nazwisko z mapą, która wiąże imię z aktówką. Dzięki temu za pomocą nazwiska można uzyskać dostęp do wszystkich imion i aktówek do nich przypisanych. Bez tych dwóch informacji nie jest możliwe dostanie się do aktówki.

Since:

0.4.0

Version:

0.4.0, 2020-08-26

Author:

Kamil Jan Mularski [@Koder95]

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AbstractFilingCabinet.MapFactory Interfejs umożliwia stworzenie mapy wiążącej imię z konkretną aktówką.
static interface	AbstractFilingCabinet.NameSetFactory Interfejs umożliwia stworzenie zbioru imion dla konkretnego nazwiska.

Constructor Summary

Constructors

Constructor and Description
AbstractFilingCabinet(Map<String,Map<String,Briefcase>> map, AbstractFilingCabinet.MapFactory mapFactory) Tworzy nowy obiekt ustawiając odpowiednią implementację mapy oraz interfejs wykorzystywany podczas dodawania nowych wartości do mapy.
AbstractFilingCabinet(Map<String,Map<String,Briefcase>> map, AbstractFilingCabinet.MapFactory mapFactory, Map<String,Set<String>> personalData, AbstractFilingCabinet.NameSetFactory nameSetFactory) Tworzy nowy obiekt ustawiając odpowiednią implementację mapy oraz interfejs wykorzystywany podczas dodawania nowych wartości do mapy.

Method Summary

Modifier and Type	Method and Description
void	add(String surname, String name, Briefcase b) Dodaje (albo zastępuje) do szafy aktówkę pod określone nazwisko i imię osoby.
void	clear() Usuwa wszystkie dane, które zawiera szafa.
Map<String,Briefcase>	get(String surname) Pobiera wszystkie aktówki, które są umieszczone pod podanym nazwiskiem.
Briefcase	get(String surname, String name)
Map<String,Set<String>>	getPersonalData()
void	remove(String surname, String name) Usuwa dane dot. osoby.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractFilingCabinet

public AbstractFilingCabinet(Map<String,Map<String,Briefcase>> map,
                             AbstractFilingCabinet.MapFactory mapFactory,
                             Map<String,Set<String>> personalData,
                             AbstractFilingCabinet.NameSetFactory nameSetFactory)

Tworzy nowy obiekt ustawiając odpowiednią implementację mapy oraz interfejs wykorzystywany podczas dodawania nowych wartości do mapy. Umożliwia również określenie przestrzeni nazwisk i imion, do których jest umożliwiony dostęp. Jeżeli parametr personalData zostanie ustalony na wartość inną niż null, wtedy można zmienić domyślną implementację mapy nazwisk. Jeżeli natomiast ta mapa zawiera już jakieś dane, tzn. nie jest pusta, wtedy dostęp do informacji jest uzależniony od tych danych. Jeżeli klient będzie chciał odwołać się do nazwiska albo imienia, którego nie ma w mapie personalData, wtedy zostanie wypluty wyjątek bezpieczeństwa. Jeżeli jest mapa jest pusta, wtedy każde wywołanie metody getPersonalData() będzie generowało nową przestrzeń nazwisk i imion w zależności od już dodanych danych do szafy.

Parameters:

map - mapa wiążąca nazwisko z mapą, która z kolei wiąże imię z aktówką

mapFactory - metoda wytwórcza dla map wiążących imię z aktówką

personalData - przestrzeń nazwisk i imion, może być pusta lub null

nameSetFactory - jeżeli personalData == null || personalData.isEmpty(), wtedy parametr ten ma znaczenie, ponieważ udostępnia możliwość tworzenia zbiorów imion dla każdego nazwiska, korzystając z dowolnej implementacji

AbstractFilingCabinet

public AbstractFilingCabinet(Map<String,Map<String,Briefcase>> map,
                             AbstractFilingCabinet.MapFactory mapFactory)

Tworzy nowy obiekt ustawiając odpowiednią implementację mapy oraz interfejs wykorzystywany podczas dodawania nowych wartości do mapy.

Parameters:

map - mapa wiążąca nazwisko z mapą, która z kolei wiąże imię z aktówką

mapFactory - metoda wytwórcza dla map wiążących imię z aktówką

Method Detail

add

public void add(String surname,
                String name,
                Briefcase b)

Description copied from interface: FilingCabinet

Dodaje (albo zastępuje) do szafy aktówkę pod określone nazwisko i imię osoby.

Specified by:

add in interface FilingCabinet

Parameters:

surname - nazwisko

name - imię (imiona)

b - aktówka

remove

public void remove(String surname,
                   String name)

Description copied from interface: FilingCabinet

Usuwa dane dot. osoby.

Specified by:

remove in interface FilingCabinet

Parameters:

surname - nazwisko

name - imię (imiona)

clear

public void clear()

Description copied from interface: FilingCabinet

Usuwa wszystkie dane, które zawiera szafa.

Specified by:

clear in interface FilingCabinet

get

public Map<String,Briefcase> get(String surname)

Description copied from interface: FilingCabinet

Pobiera wszystkie aktówki, które są umieszczone pod podanym nazwiskiem.

Specified by:

get in interface FilingCabinet

Parameters:

surname - nazwisko

Returns:

mapa aktówek, której kluczem jest imię (imiona) osoby

get

public Briefcase get(String surname,
                     String name)

Specified by:

get in interface FilingCabinet

Parameters:

surname - nazwisko

name - imię

Returns:

aktówka, która przechowywana jest pod podanym nazwiskiem i imieniem (imionami)

getPersonalData

public Map<String,Set<String>> getPersonalData()

Specified by:

getPersonalData in interface FilingCabinet

Returns:

dane osobowe w formie mapy, która każdemu nazwisku przyporządkowuje zbiór imion