.vlastnosti - .properties
Přípona názvu souboru | .vlastnosti |
---|
.vlastnosti je přípona souboru pro soubory používá se hlavně v Jáva související technologie pro ukládání konfigurovatelných aplikace. Mohou být také použity pro uložení řetězců pro Internacionalizace a lokalizace; tyto jsou známé jako balíčky zdrojů prostředků.
Každý parametr je uložen jako pár struny, jeden ukládá název parametru (nazývaného klíč) a druhý ukládající hodnotu.
Formát
Každý řádek v souboru .properties obvykle ukládá jednu vlastnost. Pro každý řádek je možné několik formátů, včetně klíč = hodnota
, klíč = hodnota
, klíč: hodnota
, a klíčová hodnota
. Jednoduché uvozovky nebo uvozovky jsou považovány za součást řetězce. Koncový prostor je významný a předpokládá se, že bude oříznut podle požadavků zákazníka.
Komentář řádky v souborech .properties jsou označeny znak čísla (#) nebo vykřičník (!) jako první non prázdný charakter, ve kterém je veškerý zbývající text na daném řádku ignorován. Zpětné lomítko se používá k úniku znaku. Níže je uveden příklad souboru vlastností.
# Čtete položku „.properties“.! Vykřičník může také označit text jako komentáře.# Klíčové znaky =, a: by měly být psány s# předchozí zpětné lomítko, aby bylo zajištěno, že jsou správně načteny.# Není však nutné předcházet hodnotové znaky =, a: zpětným lomítkem.webová stránka = https://en.wikipedia.org/Jazyk = Angličtina# Zpětné lomítko níže říká aplikaci, aby pokračovala ve čtení# hodnota na další řádek.zpráva = Vítejte v Wikipedia!# Pokud je ale počet zpětných lomítek na konci řádku sudý, další řádek není do hodnoty zahrnut. V následujícím příkladu je hodnota „klíče“ „valueOverOneLine“klíč = valueOverOneLine # Tento řádek není zahrnut v hodnotě pro „klíč“# Přidejte do klíče mezeryklíč s mezerami = Toto je hodnota, kterou lze vyhledat pomocí klíče „klíč s mezerami“.# Znaky = a: v klíči musí také uniknout:klíč:with = colonAndEqualsSign = Toto je hodnota klíče „key: with = colonAndEqualsSign“# Unicodezáložka : u0009# Pokud chcete, aby vaše nemovitost obsahovala zpětné lomítko, mělo by jí uniknout jiné zpětné lomítkocesta=c: wiki templates# Někteří redaktoři to však zpracují automaticky
Ve výše uvedeném příkladu webová stránka by byl klíč a jeho odpovídající hodnota by byla https://en.wikipedia.org/. Zatímco znak čísla (#) a vykřičník (!) Označují text jako komentáře, nemá žádný účinek, pokud je součástí vlastnosti. To je klíč zpráva má hodnotu Vítejte na Wikipedii! a ne Vítejte na Wikipedii. Celý bílý prostor před Wikipedia! je zcela vyloučen.
Před Java 9 je kódování souboru .properties ISO-8859-1, také známý jako Latin-1. Všechny znaky jiné než latinka-1 musí být zadány pomocí Unicode únikové znaky, např. uHHHH, kde HHHH je hexadecimální index znaku ve znakové sadě Unicode. To umožňuje používat soubory .properties jako svazky zdrojů pro lokalizace. Non-Latin-1 textový soubor lze převést na správný soubor .properties pomocí native2ascii nástroj, který je dodáván s JDK nebo pomocí nástroje, jako je po2prop,[1] který spravuje transformaci z dvojjazyčného lokalizačního formátu na unikající vlastnosti.
Alternativou k použití únikových znaků unicode pro znaky jiné než Latin-1 v souborech Java * .properties kódovaných pomocí znaků ISO 8859-1 je použití formátu souboru JDK XML Vlastnosti, který je ve výchozím nastavení kódován UTF-8, zavedený od Java 1.5.[2]
Další alternativou je vytvoření vlastního ovládacího prvku, který poskytuje vlastní kódování.[3]
V prostředí Java 9 a novějších je výchozí kódování souborů .properties UTF-8 a pokud dojde k neplatné sekvenci bajtů UTF-8, spadne zpět na ISO-8859-1.[4][5]
Úpravy
Úpravy souborů .properties se provádějí pomocí libovolného textový editor například ty, které se obvykle instalují na různé Operační systémy počítaje v to poznámkový blok ve Windows nebo Emacs, Vim atd. na systémech Linux.
K dispozici jsou také nástroje třetích stran s dalšími funkcemi specifickými pro úpravy souborů .properties, například:
- Ověření dat
- Vytváření nových klíčů
- Synchronizace klíčových jmen
- Automatická obousměrná konverzeASCII symboly na podporulatinský jazyky
- Integrace s Zatmění
Non-Java použití a výjimky
Apache Flex používá také soubory .properties, ale zde jsou kódovány UTF-8.[6]
v Apache mod_jk Ve formátu uriworkermap.properties je vykřičník ("!") označen a Negace operátor při použití jako první non prázdný znak v řadě.[7]
Perl CPAN obsahuje Config :: Properties k rozhraní se souborem .properties.[8]
MÍZA používá pro lokalizaci soubory .properties v rámci jejich rámce SAPUI5 a jeho open-source varianty OpenUI5 [9]
Viz také
Reference
- ^ Přeložte Toolkit je po2prop převádí nativní kódování znaků na a Gettext PO soubor do správně uniklého ascii bez nutnosti native2ascii
- ^ Vlastnosti Java XML DTD
- ^ "java - Jak používat UTF-8 ve vlastnostech prostředků s ResourceBundle". Přetečení zásobníku. Archivováno od původního dne 2015-03-25. Citováno 2015-01-28.
- ^ „Vylepšení internacionalizace v JDK 9“. Centrum nápovědy Oracle. Citováno 2018-01-05.
- ^ „JEP 226: UTF-8 Bundle Property Resource“. OpenJDK. Citováno 2020-09-03.
- ^ „IResourceBundle“. Referenční příručka k rozhraní Adobe ActionScript® 3 (AS3 Flex).
- ^ "konfigurace uriworkermap.properties". Konektory Apache Tomcat - referenční příručka.
- ^ „Config :: Properties - Číst a zapisovat soubory vlastností“. metacpan.org.
- ^ „SAPUI5 SDK - Demo Kit“. sapui5.hana.ondemand.com. Citováno 2019-05-14.
externí odkazy
java.util.Properties.load (java.io.Reader)
- dává přesnou sémantiku dobře vytvořených souborů vlastností Javajava.util.PropertyResourceBundle
- popisuje svazky zdrojů majetkujava.util.Vlastnosti
- vysvětluje vlastnosti Java v jednoduchém formátu XML.- MultiProperties - Jedná se o plugin Eclipse pro úpravy více souborů založených na páru klíč – hodnota s podobným obsahem. Tento typ formátu souboru může být Vlastnosti, například v programovacím jazyce Java, který se často používá k zálohování ResourceBundle.
- Vlastnosti závorky - aktualizace konceptu Vlastnosti při zachování všudypřítomného formátu souboru .properties beze změny.
- Editor vlastností Java (aplikace + plugin Eclipse) - užitečný nástroj pro prohlížení a úpravy souborů vlastností v celém projektu.
- Doplněk Eclipse do editoru vlastností DOKSoft - nástroj i18n pro instalaci do Eclipse IDE.
- Editor zpráv - spravuje i18n pro aplikaci Java. Generuje soubory vlastností XML. Zahrnuje dva styly pro generování vlastností .xml a XML v době kompilace (na základě Ant.)
- JLokalize - open source editor vlastností Java s funkcí obrácení a kontrolou pravopisu
- Konfigurace :: Vlastnosti - Perl CPAN.
- Jackson Vlastnosti modul je knihovna, která umožňuje mapování obsahu souboru Vlastnosti do objektů Java a zpět, podobně jako XML a JSON je běžně mapováno
- Lokálně, POEditor, Lokalita a Loco - vývojářské nástroje pro překlad a lokalizaci, které podporují soubory .properties.
- SAPUI5 - Použití lokalizovaných textů v aplikacích