com.suncode.pwfl.administration.structure

Interface StructureService

@Provides(value=StructureService.class)
public interface StructureService

Odpowiada za zarządzanie strukturą organizacyją systemu. Pozwala zarządzać jednostkami organizacyjnymi, stanowiskami, oraz powiązaniami między stanowiskami a użytkownikami.

Author:

Paweł Rosolak 27 lis 2013

Method Summary

Modifier and Type	Method and Description
void	addPositionsToUser(String userName, List<Long> positionIds) Przypisuje stanowiska do użytkwonika
void	addPositionToUser(String userName, Long positionId) Przypisuje stanowisko do użytkownika
Long	createOrganizationalUnit(OrganizationalUnit ou) Tworzy nową jednostkę organizacyjną
Long	createPosition(Position position) Tworzy nowe stanowisko
void	deleteOrganizationalUnit(Long id) Usuwa jednostkę o podanym id
void	deleteOrganizationalUnit(String symbol) Usuwa jednostkę o podanym symbolu
void	deletePosition(Long id) Usuwa stanowisko o podanym identyfikatorze
void	deletePosition(String symbol) Usuwa stanowisko o podanym symbolu
void	detachAllPositions(String userName) Odłącza wszystkie stanowiska od użytkownika
void	detachPositionFromUser(Long positionId) Odłącza stanowisko od użytkownika
OrganizationalUnit	getOrganizationalUnit(Long id, String... joins) Pobiera jednostkę organizacyjną o podanym id.
OrganizationalUnit	getOrganizationalUnit(String symbol, String... joins) Pobiera jednostkę organizacyjną o podanym symbolu.
Position	getPosition(Long id, String... joins) Pobiera stanowisko o podanym id.
Position	getPosition(String symbol, String... joins) Pobiera stanowisko o podanym symbolu.
void	updateOrganizationalUnit(OrganizationalUnit ou) Modyfikuje jednostkę organizacyjną
void	updatePosition(Position position) Modyfikuje stanwisko
void	validateOrganizationalUnit(OrganizationalUnit ou) Sprawdza następujące warunki: Czy nazwa OU nie jest pusta Czy symbol OU nie jest pusty Czy symbol OU nie jest już przypisany do innego OU
void	validatePosition(Position position) Sprawdza następujące warunki: Czy nazwa stanowiska nie jest pusta Czy symbol stanowiska nie jest pusty Czy symbol stanowiska nie jest już przypisany do innego stanowiska

Method Detail

getOrganizationalUnit

OrganizationalUnit getOrganizationalUnit(Long id,
                                         String... joins)

Pobiera jednostkę organizacyjną o podanym id. Umożliwia również dołączenie powiązanych obiektów z bazy danych.

Parameters:

id - Id jednostki organizacyjnej

joins - Określa, które elementy mamy dołączyć do obiektu jednostki organizacyjnej.

Returns:

Zwraca obiekt jednostki organizacyjnej.

Throws:

OrganizationalUnitNotFoundException - Jeżeli nie znaleziono jednostki o podanym symbolu

getOrganizationalUnit

OrganizationalUnit getOrganizationalUnit(String symbol,
                                         String... joins)

Pobiera jednostkę organizacyjną o podanym symbolu. Umożliwia również dołączenie powiązanych obiektów z bazy danych.

Parameters:

symbol - Symbol jednostki organizacyjnej

joins - Określa, które elementy mamy dołączyć do obiektu jednostki organizacyjnej.

Returns:

Zwraca obiekt jednostki organizacyjnej.

Throws:

OrganizationalUnitNotFoundException - Jeżeli nie znaleziono jednostki o podanym symbolu

createOrganizationalUnit

Long createOrganizationalUnit(OrganizationalUnit ou)

Tworzy nową jednostkę organizacyjną

Parameters:

ou - Definicja jednostki organizacyjnej

Returns:

Zwraca id zapisanego w bazie obiektu.

updateOrganizationalUnit

void updateOrganizationalUnit(OrganizationalUnit ou)

Modyfikuje jednostkę organizacyjną

Parameters:

ou - - Definicja jednostki organizacyjnej.

deleteOrganizationalUnit

void deleteOrganizationalUnit(String symbol)

Usuwa jednostkę o podanym symbolu

Parameters:

symbol - Symbol jednostki organizacyjnej

deleteOrganizationalUnit

void deleteOrganizationalUnit(Long id)

Usuwa jednostkę o podanym id

Parameters:

id - Id jednostki organizacyjnej

validateOrganizationalUnit

void validateOrganizationalUnit(OrganizationalUnit ou)
                         throws OrganizationalUnitAlreadyExistException,
                                EmptyPropertyException

Sprawdza następujące warunki:

• Czy nazwa OU nie jest pusta
• Czy symbol OU nie jest pusty
• Czy symbol OU nie jest już przypisany do innego OU

Parameters:

ou - Obiekt jednostki

Throws:

OrganizationalUnitAlreadyExistException - Wyjątek występuję jeżeli ou nie posiada zdefiniowanego id i istnieje już inna jednostka o podanym symbolu. Jeżeli ou ma zdefiniowane id to wyjątek nie zostanie rzucony, aby umożliwić walidację przed modyfikacją już istniejącej jednostki.

EmptyPropertyException

getPosition

Position getPosition(Long id,
                     String... joins)

Pobiera stanowisko o podanym id.

Parameters:

id - Id stanowiska

joins - Określa, które elementy mamy dołączyć do obiektu stanowiska.

Returns:

Zwraca obiekt stanowiska

getPosition

Position getPosition(String symbol,
                     String... joins)

Pobiera stanowisko o podanym symbolu.

Parameters:

symbol - Symbol stanowiska

joins - Określa, które elementy mamy dołączyć do obiektu stanowiska.

Returns:

Zwraca obiekt stanowiska

createPosition

Long createPosition(Position position)

Tworzy nowe stanowisko

Parameters:

position - Definicja stanowiska

Returns:

Zwraca id zapisanego w bazie obiektu.

updatePosition

void updatePosition(Position position)

Modyfikuje stanwisko

Parameters:

postion - Definicja stanowiska.

deletePosition

void deletePosition(String symbol)

Usuwa stanowisko o podanym symbolu

Parameters:

symbol - Symbol stanowiska

deletePosition

void deletePosition(Long id)

Usuwa stanowisko o podanym identyfikatorze

Parameters:

id - Identyfikator stanowiska

addPositionToUser

void addPositionToUser(String userName,
                       Long positionId)

Przypisuje stanowisko do użytkownika

Parameters:

userName - Login użytkownika

positionId - Id stanowiska

addPositionsToUser

void addPositionsToUser(String userName,
                        List<Long> positionIds)

Przypisuje stanowiska do użytkwonika

Parameters:

userName - Login użytkownika

positionIds - Lista id stanowisk

detachPositionFromUser

void detachPositionFromUser(Long positionId)

Odłącza stanowisko od użytkownika

Parameters:

userName - Login użytkownika

positionId - Id stanowiska

detachAllPositions

void detachAllPositions(String userName)

Odłącza wszystkie stanowiska od użytkownika

Parameters:

userName - Login użytkownika

validatePosition

void validatePosition(Position position)
               throws EmptyPropertyException,
                      PositionAlreadyExistException,
                      PositionNotFoundException

Sprawdza następujące warunki:

• Czy nazwa stanowiska nie jest pusta
• Czy symbol stanowiska nie jest pusty
• Czy symbol stanowiska nie jest już przypisany do innego stanowiska

Parameters:

position -

Throws:

EmptyPropertyException

PositionAlreadyExistException - Wyjątek występuje jeżeli stanowisko nie posiada zdefiniowanego id i istnieje już inne stanowisko o podanym symbolu. Jeżeli stanowisko ma zdefiniowane id to wyjątek nie zostanie rzucony, aby umożliwić walidację przed modyfikacją już istniejącego stanowiska.

PositionNotFoundException - Wyjątek występuje jeżeli obiekt stanowiska ma zdefiniowane stanowisko nadrzędne, którego nie ma w systemie.