Strona może być nieaktualna
Nikt jej nie zmieniał od 61 miesięcy (ostatni commit: 2021-09-24, Dariusz). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.
Okna czasowe - opis działania pamięci podręcznej¶
Rodzaje pamięci podręcznej dla okien czasowych¶
-
Pamięć oparta o ID okna czasowego
-
metoda odpowiedzialna za generowanie:
@Cacheable(value = CacheService.TIME_WINDOWS_CACHE, key = {timeWindow.id}) @Transactional(readOnly = true) Map asCachedMapForUniversalAccess(TimeWindow timeWindow) { timeWindow.asCommonMap() } -
podstawowa struktura mapy okna w pamięci podręcznej:
/** * Zawiera podstawowe informacje o oknie - dostępne dla wszystkich użytkowników. * * @return */ HashMap asCommonMap() { String dateFormat = "EEE MMM d yyyy HH:mm:ss 'GMT'Z" return [ id : id, ramp : rampId, start : new SimpleDateFormat(dateFormat, Locale.US).format(start), stop : new SimpleDateFormat(dateFormat, Locale.US).format(stop), deleted : deleted, isTemplate: isTemplate, note : note, state : getStateOfDisabledWindow(false) ] }
-
-
Pamięć oparta o ID okna czasowego oraz ID grupy użytkownika
Grupa użytkownika to pole
userGroupprzypisane do obiektu klasyPerson-
metoda odpowiedzialna za generowanie:
@Cacheable(value = CacheService.TIME_WINDOWS_CACHE, key = [{timeWindow.id}, {userGroup.id }]) @Transactional(readOnly = true) Map asCachedMapForUserGroup(TimeWindow timeWindow, UserGroup userGroup) { timeWindow.asMapForUserGroup(userGroup) } -
podstawowa struktura mapy okna w pamięci podręcznej:
/** * Zawiera informacje dostępne dla użytkownika o danej grupie. * * @param userGroup * @return */ HashMap asMapForUserGroup(UserGroup userGroup) { HashMap map = asCommonMap() Long windowCompanyId = canCompanyInfoBeAccessedByUserGroup(userGroup) ? this.company?.id : null map.company = windowCompanyId Long windowUserGroupId = canUserGroupInfoBeAccessedByUserGroup(userGroup) ? this.userGroup?.id : null map.userGroup = windowUserGroupId if (transportId && (!userGroup?.company || (userGroup?.company?.canAccess(transport) && transport.canBeAccessedBy(userGroup)))) { map.step = stepId map.transport = transportId map.transportType = transport?.transportTypeId map << scheduleSettingService.findSectionsContentForTimeWindow(transport, this) map.wasDelayedOnMarkedTask = wasDelayedOnMarkedTask() map.color = findColor() map.state = WINDOW_STATE_CLASS.transport } else { Boolean hasCompanyOrUserGroup = windowCompanyId || windowUserGroupId map.state = getStateOfDisabledWindow(hasCompanyOrUserGroup) } return map }
-
Generowanie oraz pobieranie z pamięci mapy okna czasowego¶
Za generowanie odpowiedniej mapy okna czasowego odpowiedzialna jest metoda:
/**
* Próbuje zwrócić mapę okna zapisaną w pamięci podręcznej lub, jeśli zakończy się to błędem, na nowo wygenerować mapę.
*/
@Transactional(readOnly = true)
Map asMap(TimeWindow timeWindow, UserGroup userGroup = null) {
try {
if (timeWindow.isBlockade() || !timeWindow.isUserGroupInvolved(userGroup)) {
grailsApplication.mainContext.warehouseService.asCachedMapForUniversalAccess(timeWindow)
} else {
grailsApplication.mainContext.warehouseService.asCachedMapForUserGroup(timeWindow, userGroup)
}
} catch (Exception e) {
e.printStackTrace()
if (userGroup && timeWindow.isUserGroupInvolved(userGroup)) {
return timeWindow.asMapForUserGroup(userGroup)
} else {
return timeWindow.asCommonMap()
}
}
}
Definicja metody
isUserGroupInvolved(userGroup):
/**
* Określa, czy podana grupa jest zaangażowana w okno czasowe.
*
* <ul>
* <li> Dostęp do okna mają na pewno wszystkie grupy pryncypała
* <li> Jeżeli jest to okno z transportem, zaangażowani są wszyscy wykonawcy {@link TimeWindow#getExecutorCompanies()}
* <li> Jeżeli jest to okno dedykowane firmie {@link TimeWindow#company}, zaangażowane są wszystkie grupy tej firmy
* <li> Jeżeli jest to okno dedykowane grupie {@link TimeWindow#userGroup}, zaangażowana jest ta grupa oraz
* pozostałe grupy jej firmy, które mają prawo dostępu do transportów pozostałych grup
*
* @param userGroup
* @return
*/
Boolean isUserGroupInvolved(UserGroup userGroup) {
if (!userGroup || isBlockade()) {
return false
}
if (this.companyId && this.companyId == userGroup.companyId) {
// Okno jest oknem dedykowanym firmie -> grupa jest więc zaangażowana.
return true
}
if (this.userGroupId && canUserGroupInfoBeAccessedByUserGroup(userGroup)) {
// Okno jest oknem dedykowanym grupie -> grupa jest więc zaangażowana.
return true
}
if (this.transportId && userGroup.company?.canAccess(this.transport)) {
// Okno jest związane z transportem $transport i grupa ma do niego dostęp -> grupa jest więc zaangażowana.
return true
}
// Grupa należy do pryncypała -> ma dostęp do okna. W przeciwnym razie grupa nie jest
// zaangażowana w okno -> będzie je widziała jako blokadę.
return userGroup.company.isCurrentPrincipal()
}
Miejsca oraz akcje wywołujące pobranie mapy okna czasowego w aplikacji¶
Informacje wstępne: - tablica
timeWindowIdsprzychodzi po wykonaniu zapytania doTimeWindowRESTControllerdo metodyupdates(Long warehouseId), która zbiera listę okien czasowych o czasie w polulastUpdatedwiększym od ostatniego zapytania tej metody (updates(Long warehouseId)).
- grupa użytkownika brana jest z polauserGroupw klasiePerson.
-dostępne dodatkowe zasobytyczy się m.in. otrzymanegojsonoraz informacji zSpringSecurity
-
Pobranie mapy pojedynczego okna
- klasa:
TimeWindowRESTController - metoda:
show(TimeWindow) - dostępne dodatkowe zasoby:
id okna czasowegoaktualnie zalogowany użytkownik
Akcje powodujące pobranie mapy:
- automatyczne odświeżanie Harmonogramu - zapytanie o dane okien, które przyszły w tablicytimeWindowIds:
-
ręczne odświeżenie Harmonogramu (za pomocą klawisza
Odświeżw Harmonogramie)- zapytanie o dane okien, które przyszły w tablicy
timeWindowIds
- zapytanie o dane okien, które przyszły w tablicy
-
zapisanie okna czasowego
- po zapisaniu okna czasowego wywoływane jest automatycznie zapytanie o
updates(Long warehouseId), które zwraca co najmniejidzapisanego okna i powoduje pobranie jego mapy - dodatkowo po kolejnym odświeżaniu wychodzi zapytanie o dane okien, które przyszły w tablicy
timeWindowIds- w tym przypadku w tablicy będzie co najmniejidzapisanego okna
- po zapisaniu okna czasowego wywoływane jest automatycznie zapytanie o
-
usunięcie okna czasowego
- po kolejnym odświeżaniu po usunięciu wychodzi zapytanie o dane okien, które przyszły w tablicy
timeWindowIds- w tym przypadku w tablicy będzie co najmniejidusuniętego okna
- po kolejnym odświeżaniu po usunięciu wychodzi zapytanie o dane okien, które przyszły w tablicy
-
edycja okna czasowego
- po kolejnym odświeżaniu po edycji wychodzi zapytanie o dane okien, które przyszły w tablicy
timeWindowIds- w tym przypadku w tablicy będzie co najmniejidedytowanego okna
- po kolejnym odświeżaniu po edycji wychodzi zapytanie o dane okien, które przyszły w tablicy
-
zamiana miejscami okien czasowych
- po kolejnym odświeżaniu po zamianie wychodzi zapytanie o dane okien, które przyszły w tablicy
timeWindowIds- w tym przypadku w tablicy będą co najmniejidzmienianych okien
- po kolejnym odświeżaniu po zamianie wychodzi zapytanie o dane okien, które przyszły w tablicy
- klasa:
-
Pobranie listy okien czasowych
- klasa:
TimeWindowRESTController - metoda:
index(Integer) - dostępne dodatkowe zasoby:
mapa z danymi: [start, stop, rampsIds, warehouseId, isTemplate]aktualnie zalogowany użytkownikaktualny pryncypał
Akcje powodujące pobranie mapy:
- wyświetlenie Harmonogramu - zapytanie o listę okien z danego magazynu, danego przedziału wyświetlania (jeśli odwiedzamy Harmonogram pierwszy raz po zalogowaniu lub odświeżyliśmy stronę przeglądarki)
- klasa:
-
Zapisanie okna czasowego
- klasa:
TimeWindowRESTController - metoda:
save() - dostępne dodatkowe zasoby:
mapa z danymi oknaaktualnie zalogowany użytkownik
Akcje powodujące pobranie mapy:
- zapisanie okna czasowego - klasa:
-
Usunięcie okna czasowego
- klasa:
TimeWindowRESTController - metoda:
delete(TimeWindow) - dostępne dodatkowe zasoby:
id okna czasowegoaktualnie zalogowany użytkownik
Akcje powodujące pobranie mapy:
- usunięcie okna czasowego - klasa:
-
Edycja okna czasowego
- klasa:
TimeWindowRESTController - metoda:
update(timeWindowId) - dostępne dodatkowe zasoby:
aktualnie zalogowany użytkownik
Akcje powodujące pobranie mapy:
- edycja okna czasowego - zamiana miejscami okien czasowych
- metodaupdate(timeWindowId)wywoływana jest dla obu okien - klasa:
-
Generowanie pamięci podręcznej w panelu administratora
Powoduje wygenerowanie zarówno mapy
asMapForUserGroup(userGroup)jak i mapyasCommonMap()dla okien z wybranego zakresu.
Miejsca oraz akcje wywołujące wyczyszczenie mapy okna czasowego w aplikacji¶
Wszystkie podane przypadki czyszczą pamięć podręczną okna
asCommonMaporazasMapForUserGroupbiorąc grupy z metodyinvolvedUserGroupsklasyTimeWindowwywoływanej na oknie czasowym.
-
Panel Administratora
- czyszczenie dla pojedynczego okna
- czyszczenie dla wszystkich okien
- czyszczenie dla transportu - jeśli transport posiada okna czasowe
- przeniesienie zlecenia do archiwum
- anulowanie/Edycja transakcji
- sprawdzanie stanu transportu
-
Zmiana pola
visibleOnTimeWindoww klasieCustomFieldDefinition
- czyszczenie dla okien typu transportu, który posiada dane pole niestandardowe z zakresu czasu:
- od - aktualny czas minus interwał podany wParameter.TIME_WINDOW_CLEAR_CACHE_INTERVAL_AFTER_SAVE_CUSTOM_FIELDS
- do - aktualny czas -
Zapisanie transportu - jeśli transport od razu posiada okno/okna czasowe
-
Edycja transportu - jeśli transport posiada okno/okna czasowe
-
Usuwanie transportu - jeśli transport posiada okno/okna czasowe
-
Przesunięcie okna czasowego - czyszczenie w dwóch miejscach
- metoda
moveWindowwWarehouseService - metoda
updatewTimeWindowRESTController
- metoda
-
Zamiana miejscami okien czasowych - czyszczenie dla obu okien
-
Edycja awizacji przez SMS
-
Automatyczne usuwanie okien dedykowanych
Od punktu 10. wymienione akcje powodują wyczyszczenie pamięci dla transportu oraz jeśli transport posiada okna czasowe to wyczyszczenie pamięci okien -
Zakończenie aukcji dla transportu
-
Edycja indeksu w transporcie
-
Zapisanie transakcji do transportu
-
Odrzucenie/Przyjęcie transakcji przez przewoźnika
-
Zapisanie faktury do zlecenia
-
Ważenie w transporcie
-
Synchronizacja wagi w transporcie
-
Edycja kierowcy (w zasobach firmy)
-
Edycja ciągnika (w zasobach firmy)
Ostatnia zmiana: 2021-09-24 · Dariusz
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e