shared
Interface InterfejsOgloszenia

All Superinterfaces:
java.rmi.Remote
All Known Implementing Classes:
KatalogOgloszen

public interface InterfejsOgloszenia
extends java.rmi.Remote

Sieciowy interfejs klasy KatalogOgloszen.


Method Summary
 void aktualizujTrescOgloszenia(Ogloszenie ogloszenie)
          Aktualizuje treść ogłoszenia będącego w systemie.
 java.util.List nieaktualneOgloszenia()
          Odnajduje wszystkie ogłoszenia, którym upłynął termin aktualizacji, a aktualność nie została potwierdzona przez firmę.
 java.util.List nieoplaconeOgloszenia()
          Odnajduje wszystkie ogłoszenia firm wymagających, którym upłynął (lub jest bliski upłynięcia) termin płatności.
 java.util.List noweOgloszenia()
          Odnajduje wszystkie ogłoszenia, które zostały ostatnio dodane do systemu i wymagają akceptacji administratora.
 Ogloszenie ogloszenieFirmy(Nip nip)
          Zwraca ogłoszenie zadanej firmy.
 void potwierdzAktualnosc(Ogloszenie ogloszenie)
          Zleca wykonanie aktualizacji.
 void przedluzTermin(OgloszeniePlatne platne, java.util.Date doKiedy)
          Przedłuża termin opłacenia ogłoszenia płatnego.
 void usunOgloszenie(Ogloszenie ogloszenie)
          Usuwa zadane ogłoszenie.
 java.util.List wszystkieOgloszenia()
          Zwraca wszystkie ogłoszenia znajdujące się w systemie.
 java.util.List wyborOgloszen(Kryteria kryteria)
          Odnajduje zestaw ogłoszeń spełniających dane kryteria.
 void zatwierdzNoweOgloszenie(Ogloszenie ogloszenie)
          Zatwierdza nowo dodane do systemu ogłoszenie.
 void zerujPopularnosc()
          Zeruje licznik popularności dla wszystkich ogłoszeń.
 void zmienNaBezplatne(OgloszeniePlatne ogloszenie)
          Zmienia podane ogłoszenie płatne na bezpłatne.
 

Method Detail

noweOgloszenia

public java.util.List noweOgloszenia()
                              throws Wyjatek,
                                     java.rmi.RemoteException
Odnajduje wszystkie ogłoszenia, które zostały ostatnio dodane do systemu i wymagają akceptacji administratora.

Returns:
lista nowych ogłoszeń
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

nieaktualneOgloszenia

public java.util.List nieaktualneOgloszenia()
                                     throws Wyjatek,
                                            java.rmi.RemoteException
Odnajduje wszystkie ogłoszenia, którym upłynął termin aktualizacji, a aktualność nie została potwierdzona przez firmę.

Returns:
lista nieaktualnych ogłoszeń
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

nieoplaconeOgloszenia

public java.util.List nieoplaconeOgloszenia()
                                     throws Wyjatek,
                                            java.rmi.RemoteException
Odnajduje wszystkie ogłoszenia firm wymagających, którym upłynął (lub jest bliski upłynięcia) termin płatności.

Returns:
lista nieopłaconych ogłoszeń
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

wyborOgloszen

public java.util.List wyborOgloszen(Kryteria kryteria)
                             throws Wyjatek,
                                    java.rmi.RemoteException
Odnajduje zestaw ogłoszeń spełniających dane kryteria. Wraz z ogłoszeniami przesyła fragment mapy (jeśli użytkownik zażądał wyszukiwania z mapą) oraz zestaw telefonów do każdego ogłoszenia.

Parameters:
kryteria - kryteria wyszukiwania
Returns:
lista ogłoszeń zgodnych z kryteriami i telefonów
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych lub podane parametry są niepoprawne
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

usunOgloszenie

public void usunOgloszenie(Ogloszenie ogloszenie)
                    throws Wyjatek,
                           java.rmi.RemoteException
Usuwa zadane ogłoszenie.

Parameters:
ogloszenie - ogłoszenie do usunięcia
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

zmienNaBezplatne

public void zmienNaBezplatne(OgloszeniePlatne ogloszenie)
                      throws Wyjatek,
                             java.rmi.RemoteException
Zmienia podane ogłoszenie płatne na bezpłatne.

Parameters:
ogloszenie - zmieniane ogłoszenie
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

ogloszenieFirmy

public Ogloszenie ogloszenieFirmy(Nip nip)
                           throws Wyjatek,
                                  java.rmi.RemoteException
Zwraca ogłoszenie zadanej firmy.

Parameters:
nip - nip firmy, której ogłoszenia poszukujemy
Returns:
ogłoszenie tej firmy
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

zerujPopularnosc

public void zerujPopularnosc()
                      throws Wyjatek,
                             java.rmi.RemoteException
Zeruje licznik popularności dla wszystkich ogłoszeń. Licznik z danego miesiąca przepisuje na poprzedni miesiąc. Metoda powinna być wywoływana co pewien ustalony okres np. miesiąc, aby statystyki były wiarygodne.

Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

potwierdzAktualnosc

public void potwierdzAktualnosc(Ogloszenie ogloszenie)
                         throws Wyjatek,
                                java.rmi.RemoteException
Zleca wykonanie aktualizacji.

Parameters:
ogloszenie - aktualizowane ogłoszenie
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

zatwierdzNoweOgloszenie

public void zatwierdzNoweOgloszenie(Ogloszenie ogloszenie)
                             throws Wyjatek,
                                    java.rmi.RemoteException
Zatwierdza nowo dodane do systemu ogłoszenie.

Parameters:
ogloszenie - ogloszenie zaakceptowane przez administratora
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

aktualizujTrescOgloszenia

public void aktualizujTrescOgloszenia(Ogloszenie ogloszenie)
                               throws Wyjatek,
                                      java.rmi.RemoteException
Aktualizuje treść ogłoszenia będącego w systemie.

Parameters:
ogloszenie - aktualizowane przez administratora ogłoszenie
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

wszystkieOgloszenia

public java.util.List wszystkieOgloszenia()
                                   throws Wyjatek,
                                          java.rmi.RemoteException
Zwraca wszystkie ogłoszenia znajdujące się w systemie.

Returns:
lista ogłoszeń potrzebna w celach administracyjnych
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

przedluzTermin

public void przedluzTermin(OgloszeniePlatne platne,
                           java.util.Date doKiedy)
                    throws Wyjatek,
                           java.rmi.RemoteException
Przedłuża termin opłacenia ogłoszenia płatnego.

Parameters:
platne - płatne ogłoszenie, którego termin przedłużamy
doKiedy - data, do kiedy dane ogłoszenie jest opłacone
Throws:
Wyjatek - gdy wystąpi błąd w dostępie do bazy danych
java.rmi.RemoteException - w przypadku błędu komunikacji sieciowej

NIIKT, Zespół Gr0No3