Comments (2)
Po dłuższym przemyśleniu wydaje mi się, że ten sposób migrowania konfiguracji nie ma kompletnie sensu, bo rozwiązuje jedynie bardzo proste przypadki i przez to nie jest zbytnio użyteczny (jeśli w ogóle).
- co jeśli chcę zmienić klucz kolejny raz? Osoby, które pominą tę wersję, będą mieć kłopot (no powiedzmy, że można to zrealizować poprzez zrobienie tej adnotacji repeatable albo pozwolic na listę "starych" kluczy, ale nadal jest to bardzo prymitywne)
- brak możliwości konwersji typu (poza tym co powiedzmy, że okaeri-configs może samo spróbować), czyli nie można np. zamienić pojedynczego elementu na listę i zrobić podobnych rzeczy
- dostęp do subconfigów i przenoszenie między poziomami jest niezbyt realny (patrz próba migracji z
root->mysqlPassword
doroot->mysql->password
, albo – co gorsza – odwrotnie [do góry]) - brak możliwości modyfikacji migrowanego pola (nie można zrobić w ten sposób np. replace tekstu czy switcha aktualizującego stare warianty, nie ma możliwości bulk update)
- i pewnie wiele więcej...
Podczas gdy jakaś drobna abstrakcja i wsparcie może by się przydało, pewnie trzeba by to zrealizować poprzez pliki migracji (jakiś interfejs do implementowania) i wtedy najwyżej nad root configiem albo niżej zależnie od potrzeb można by dać adnotację rejestrująca.
Prawda jest jednak taka, że to po prostu byłby glorified override OkaeriConfig#load
posypany brokatem abstrakcji — migracje są obecnie już możliwe w ten sposób i są znacznie bardziej elastyczne.
Ewentualny system migracji jedynie mógłby standaryzować to w jakiś sposób. Zakładam jednak, że i tak pewnie niedużo więcej niż automatyczne odpalanie z adnotacji (bo nie każdy np. chce mieć pole version
, może chcieć sprawdzać w inny sposób czy migracja jest applicable itp.) — czyli po prostu przeniesienie linijek odwołujących się do migracji z #load do adnotacji.
Przykład prostego rename
@Override
public OkaeriConfig load() throws OkaeriException {
super.load();
if (this.getConfigurer().keyExists("oldKey")) {
this.set("newKey", this.getConfigurer().getValue("oldKey"));
}
return this;
}
Należy zwrócić uwagę, że podczas gdy większość backendów załaduje za pierwszym razem do pamięci nieistniejące już w POJO klucze, by design przy następnym zapisie zostają one pominięte.
Ze względu na to, że nie ma już gettera do starego klucza oraz np. załadowanie backendem json gdzie kiedyś był int, może zwrócić double albo float, należy:
- pobrać raw wartość bezpośrednio z
Configurer#getValue(String)
lub pobrać wartość z konwersją typu korzystając z metodyConfigurer#getValue(String, Class, GenericsDeclaration, SerdesContext)
- użyć raw set (który spróbuje dokonać konwersji gdy zajdzie taka potrzeba) lub gdy jesteśmy pewni co do naszego typu użyć settera POJO
Przykład promocji poziomu
@Override
public OkaeriConfig load() throws OkaeriException {
super.load();
Map<String, Object> document = this.asMap(this.getConfigurer(), true);
Object mysqlPassword = this.extractValue(document, "mysql->password");
if (mysqlPassword != null) {
this.set("mysqlPassword", mysqlPassword);
}
return this;
}
protected Object extractValue(Map<?, ?> document, String path) {
for (String part : path.split("->")) {
Object element = document.get(part);
if (element instanceof Map) {
document = (Map<?, ?>) element;
continue;
}
return element;
}
return null;
}
Funkcja extractValue
jest zapożyczona z okaeri-persistence
, to chyba najbardziej uniwersalny sposób na dobranie się do wartości głębiej, który powinien działać w niezależnie od backendu. Tutaj akurat prawdopodobnie przydałoby się coś bardziej ujednoliconego wbudowane w okaeri-configs
. Analogicznie można zbudować przeniesienie głębiej (insertValue
) lub skorzystać z setterów w nowym POJO.
from okaeri-configs.
Dodane w 4.0.0-beta14
. Przykłady użycia w FunnyGuilds/FunnyGuilds@209249b.
public class T0001_Update_player_list_animated extends NamedMigration {
public T0001_Update_player_list_animated() {
super(
"Preserve behavior of empty tablist pages by updating player-list-animated",
when(
match("pages", v -> v instanceof Collection && ((Collection<?>) v).isEmpty()),
update("player-list-animated", (old) -> false)
)
);
}
}
from okaeri-configs.
Related Issues (20)
- Nested Object Serialization HOT 1
- No comments for all options HOT 3
- Not compatible with Java 17 HOT 5
- JSON Gson configs do not encode special characters HOT 3
- Null value after config update HOT 7
- Newly added variables are not in the proper order HOT 4
- Deserialization of Map<MyEnum, List<MyOkaeriConfig>> results in Map<MyEnum, List<LinkedHashMap>> HOT 2
- Orphaned keys not removed after save HOT 1
- Empty string is added each time the configuration is loaded. HOT 4
- Subconfigurations validation seem to be not implemented HOT 1
- Comments inside subconfigs from collections and maps don't work HOT 1
- Itemstack serializer do not serialize a color HOT 1
- Extend serdes-bukkit's ItemStackSerializer with support for complex items
- Give access to root object in serializer HOT 5
- Add TOML support HOT 4
- YamlSnakeYamlConfigurer isn't compatible with latest versions of snakeyaml
- Minestom (Community Edition) platform HOT 2
- Add friendly exception messages for errors
- failed to #getValue for crates and Cannot cast me.paradis.smashcratess.crates.actions.MessageAction to java.util.List HOT 3
- Support for `.properties` file
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from okaeri-configs.