Ez a lap egy ellenőrzött változata
Properties | |
Fájlkiterjesztés | .properties |
Formátum típusa | ASCII |
A.properties egyfájlkiterjesztés olyan fájlokra, melyeket főleg aJava-val kapcsolatos technológiák használnakalkalmazás konfigurációs paraméterek tárolására. Továbbá használjákinternacionalizálás és honosítási stringek tárolására is, ezeket tulajdonság erőforrás csomagoknak (angolul Property Resource Bundles) nevezik.
Minden paraméterstring páronként van tárolva, a pár első tagja jelenti a paraméter nevét (ez akulcs), a második paraméter értéket.
Egy .properties fájlban minden sor általában egy tulajdonságot jelöl. Számos formátum alkalmazható az egyes sorokra pl.key=value
,key = value
,key:value
, éskey value
.
A .properties fájlokban használhatók a következő írásjelek: '#','!'. A sor első nem üreskarakterhelyén ezek azt jelölik, hogy a sor teljes tartalma komment (megjegyzés). A fordított perjel ('\') egy vezérlő karakter, amely karaktere escape-elésére használható. A lenti példa egy .properties fájlt mutat be.
# You are reading the ".properties" entry.! The exclamation mark can also mark text as comments.website=https://en.wikipedia.org/language=English# The backslash below tells the application to continue reading# the value onto the next line.message=Welcome to\Wikipedia!# Add spaces to the keykey\with\spaces=This is the value that could be looked up with the key "key with spaces".# Unicodetab:\u0009
A fenti példában awebsite
a kulcs, és a hozzátartozó érték pedig ahttps://en.wikipedia.org/
. Habár a kettős kereszt és a felkiáltójel a szöveget megjegyzéssé teszi, hatásuk nem érvényesül, ha a tulajdonság részei egyben. Ezért amessage
kulcs értékeWelcome to Wikipedia!
és nemWelcome to Wikipedia
. Továbbá érdemes megjegyezni, hogy az összes üres karakter aWikipedia!
előtt teljesen ki van hagyva az értékből.
AzApache Tomcat-nél a felkiáltójel egytagadás operatort jelent, egy sorban az első nemüreskarakter helyen.
Egy .properties fájl kódolásaISO-8859-1, más néven Latin-1. Az összes nem Latin-1 karaktert azUnicode escape karakterek használatával kell megadni, pl. \uHHHH, ahol a HHHH egy hexadecimális szám, mely megadja az adott karakter helyét az Unicode karakterkészletben.Ez lehetővé teszi a .properties fájlok használatátJava erőforrás csomagokkénthonosításra. Egy nem Latin-1-es szövegfájl átalakítható egy hibátlan .properties fájllá aznative2ascii nevű eszköz használatával, amely aJDK része, vagy olyan eszköz használatával mint amilyen pl. a po2prop,[1] amely a kétnyelvű lokalizációs formátumból az escape-elt .proerties fájlba történő transzformációt kezeli.
Az ISO 8859-1 karakterkódolást használó Java *.properties fájloknál egy másik alternatíva az unicode escape karakterek használatára nem latin-1 karakterek esetén azXML Properties fájl formátum használata, amely alapértelmezetten UTF-8-as kódolást használ, és Java 1.5-ben került bevezetésre.[2]
Az Adobe Flex szintén használ .properties fájlokat, deUTF-8 kódolással.[3]
PropertiesmyProps=newProperties();FileInputStreammyInputStream=newFileInputStream("myPropertiesFile.properties");myProps.load(myInputStream);StringmyPropValue=myProps.getProperty("propKey");Stringkey="";Stringvalue="";for(Map.Entry<Object,Object>propItem:myProps.entrySet()){key=(String)propItem.getKey();value=(String)propItem.getValue();// do sg with these}myInputStream.close();// better in finally blockmyProps.setProperty("propKey","myNewPropValue");FileOutputStreammyOutputStream=newFileOutputStream("yourPropertiesFile.properties");myProps.store(MyOutputStream,"myAddedKey: myAddedValue");myOutputStream.close();// better in finally block
java.util.Properties.load(java.io.Reader)
- egy jól formált Java property fájlnak megadja a pontos szemantikájátjava.util.PropertyResourceBundle
- leírja a property erőforráshoz tartozó dolgokatjava.util.Properties
- a Java properies-t kifejti egy egyszerű xml formátumban.Ez a szócikk részben vagy egészben a(z).properties című angol Wikipédia-szócikkezen változatának fordításán alapul. Az eredeti cikk szerkesztőit annak laptörténete sorolja fel. Ez a jelzés csupán a megfogalmazás eredetét és a szerzői jogokat jelzi, nem szolgál a cikkben szereplő információk forrásmegjelöléseként.