public class Properties extends Hashtable<Object,Object>
Propertiesã¯ã©ã¹ã¯ãããããã£ã®æ°žç¶ã»ããã衚ããŸãã Propertiesããã¹ããªãŒã ãžä¿ç®¡ããããã¹ããªãŒã ããããŒããããã§ããŸãã ããããã£ã»ãªã¹ãã®åããŒãããã³ããã«å¯Ÿå¿ããå€ã¯æååã§ãã
ããããã£ã»ãªã¹ãã«ã¯ããã®ãããã©ã«ãå€ããšããŠå¥ã®ããããã£ã»ãªã¹ããå«ããããšãã§ããŸããå ã®ããããã£ã»ãªã¹ãã§ããããã£ã»ããŒãèŠã€ãããªãå Žåã¯ããã®2çªç®ã®ããããã£ã»ãªã¹ããæ€çŽ¢ãããŸãã
Propertiesã¯Hashtableãç¶æ¿ããã®ã§ãPropertiesãªããžã§ã¯ãã«å¯ŸããŠputã¡ãœããããã³putAllã¡ãœãããé©çšã§ããŸãã ãããããããã®ã¡ãœããã䜿çšããããšã¯æšå¥šãããŸããããããã®ã¡ãœããã䜿ããšãåŒåºãåŽã¯ããŒãŸãã¯å€ãStringsã§ã¯ãªããšã³ããªãæ¿å
¥ã§ããããã§ãã setPropertyã¡ãœããã代ããã«äœ¿çšããŠãã ããã String以å€ã®ããŒãŸãã¯å€ãæ ŒçŽãããå®å
šæ§ã®äœããPropertiesãªããžã§ã¯ãã§storeã¡ãœãããŸãã¯saveã¡ãœãããåŒã³åºããããšããã®åŒåºãã¯å€±æããŸãã åæ§ã«ãString以å€ã®ããŒãæ ŒçŽãããå®å
šæ§ã®äœããPropertiesãªããžã§ã¯ãã§propertyNamesãŸãã¯listã¡ãœãããåŒã³åºããããšããã®åŒåºãã¯å€±æããŸãã
load(Reader)/store(Writer, String)ã¡ãœããã¯ã以äžã«ç€ºãåçŽè¡æåã®ãã©ãŒãããã§ããããã£ãæåããŒã¹ã»ã¹ããªãŒã ã«å¯ŸããŠããŒãããã³æ ŒçŽããŸãã load(InputStream)/store(OutputStream, String)ã¡ãœããã¯load(Reader)/store(Writer, String)ãã¢ãšåæ§ã«åäœããŸãããå
¥å/åºåã¹ããªãŒã ãISO 8859-1æåãšã³ã³ãŒãã£ã³ã°ã§ãšã³ã³ãŒããããç¹ãç°ãªããŸãã ãã®ãšã³ã³ãŒãã£ã³ã°ã§çŽæ¥è¡šçŸã§ããªãæåã¯ããJavaâ¢èšèªä»æ§ãã®ã»ã¯ã·ã§ã³3.3ã§å®çŸ©ãããŠããUnicodeãšã¹ã±ãŒãã䜿çšããŠèšè¿°ã§ããŸãããšã¹ã±ãŒãã»ã·ãŒã±ã³ã¹ã§èš±å¯ãããã®ã¯ãåäžãuãæåã ãã§ãã native2asciiããŒã«ã䜿çšãããšãããããã£ã»ãã¡ã€ã«ãã»ãã®æåãšã³ã³ãŒãã£ã³ã°ã«å€æãããããã®éãå®è¡ã§ããŸãã
loadFromXML(InputStream)ããã³storeToXML(OutputStream, String, String)ã¡ãœããã¯ãããããã£ãåçŽãªXML圢åŒãšããŠããŒãããã³æ ŒçŽã§ããŸãã ããã©ã«ãã§ã¯UTF-8æåãšã³ã³ãŒãã£ã³ã°ã䜿çšãããŸãããå¿
èŠã«å¿ããŠãšã³ã³ãŒãã£ã³ã°ãæå®ã§ããŸãã å®è£
ã¯UTF-8ãšUTF-16ããµããŒãããå¿
èŠãããããã®ä»ã®ãšã³ã³ãŒãã£ã³ã°ããµããŒãã§ããŸãã XMLããããã£ã»ããã¥ã¡ã³ãã§ã¯ã次ã®DOCTYPE宣èšã䜿çšãããŸãã
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">ããããã£ããšã¯ã¹ããŒã/ã€ã³ããŒããããšãã«ãã·ã¹ãã URI (http://java.sun.com/dtd/properties.dtd)ã«ã¯ã¢ã¯ã»ã¹ããŸãããã·ã¹ãã URIã¯ãDTDãäžæã«èå¥ããæååãšããŠäœ¿çšãããŸãããã®å å®¹ã¯æ¬¡ã®ãšããã§ãã
<?xml version="1.0" encoding="UTF-8"?>
<!-- DTD for properties -->
<!ELEMENT properties ( comment?, entry* ) >
<!ATTLIST properties version CDATA #FIXED "1.0">
<!ELEMENT comment (#PCDATA) >
<!ELEMENT entry (#PCDATA) >
<!ATTLIST entry key CDATA #REQUIRED>
ãã®ã¯ã©ã¹ã¯ã¹ã¬ããã»ãŒãã§ããå€éšã®åæåãè¡ããªããŠããè€æ°ã®ã¹ã¬ããã§åäžã®Propertiesãªããžã§ã¯ããå ±æã§ããŸãã
| 修食åãšå | ãã£ãŒã«ã | 説æ |
|---|---|---|
protected Properties |
defaults |
ããããã£ã»ãªã¹ãã«ãªãããŒã®ããã©ã«ãå€ãæã€ããããã£ã»ãªã¹ãã§ãã
|
| ã³ã³ã¹ãã©ã¯ã¿ | 説æ |
|---|---|
Properties() |
ããã©ã«ãå€ãæããªã空ã®ããããã£ã»ãªã¹ããäœæããŸãã
|
Properties(Properties defaults) |
æå®ãããããã©ã«ãå€ãæã€ç©ºã®ããããã£ã»ãªã¹ããäœæããŸãã
|
| 修食åãšå | ã¡ãœãã | 説æ |
|---|---|---|
String |
getProperty(String key) |
æå®ãããããŒãæã€ããããã£ããããããã£ã»ãªã¹ãããæ¢ããŸãã
|
String |
getProperty(String key, String defaultValue) |
æå®ãããããŒãæã€ããããã£ããããããã£ã»ãªã¹ãããæ¢ããŸãã
|
void |
list(PrintStream out) |
æå®ãããåºåã¹ããªãŒã ã«ãããããã£ã»ãªã¹ããåºåããŸãã
|
void |
list(PrintWriter out) |
æå®ãããåºåã¹ããªãŒã ã«ãããããã£ã»ãªã¹ããåºåããŸãã
|
void |
load(InputStream inStream) |
å
¥åãã€ãã»ã¹ããªãŒã ããããŒãšèŠçŽ ã察ã«ãªã£ãããããã£ã»ãªã¹ããèªã¿èŸŒã¿ãŸãã
|
void |
load(Reader reader) |
ããããã£ã»ãªã¹ã(ããŒãšèŠçŽ ã®ãã¢)ãå
¥åæåã¹ããªãŒã ããåçŽãªè¡æå圢åŒã§èªã¿èŸŒã¿ãŸãã
|
void |
loadFromXML(InputStream in) |
æå®ãããå
¥åã¹ããªãŒã äžã®XMLããã¥ã¡ã³ãã«ãã衚ããããã¹ãŠã®ããããã£ãããã®ããããã£è¡šã«ããŒãããŸãã
|
Enumeration<?> |
propertyNames() |
ã¡ã€ã³ã»ããããã£ã»ãªã¹ãã«åãååã®ããŒãèŠã€ãããªãå Žåã¯ãããã©ã«ãã®ããããã£ã»ãªã¹ãã«ããåå¥ã®ããŒãå«ãããã®ããããã£ã»ãªã¹ãã«ãããã¹ãŠã®ããŒã®åæãè¿ããŸãã
|
void |
save(OutputStream out, String comments) |
éæšå¥šã
ãã®ã¡ãœããã¯ãããããã£ã»ãªã¹ãã®ä¿åäžã«å
¥åºåãšã©ãŒãçºçããŠããIOExceptionãã¹ããŒããŸããã ããããã£ã»ãªã¹ãã®ä¿åã«æšå¥šãããæ¹æ³ã¯ã
store(OutputStream out, String comments)ã¡ãœãããŸãã¯storeToXML(OutputStream os, String comment)ã¡ãœããã䜿çšããããšã§ãã |
Object |
setProperty(String key, String value) |
Hashtableã®ã¡ãœãã
putãåŒã³åºããŸãã |
void |
store(OutputStream out, String comments) |
ãã®
Properties衚å
ã®ãã®ããããã£ã»ãªã¹ã(ããŒãšèŠçŽ ã®ãã¢)ããload(InputStream)ã¡ãœããã䜿çšããŠProperties衚ã«ããŒãããã®ã«é©ãã圢åŒã§åºåã¹ããªãŒã ã«æžã蟌ã¿ãŸãã |
void |
store(Writer writer, String comments) |
ãã®
Properties衚å
ã®ãã®ããããã£ã»ãªã¹ã(ããŒãšèŠçŽ ã®ãã¢)ããload(Reader)ã¡ãœããã䜿çšããã®ã«é©ãã圢åŒã§åºåæåã¹ããªãŒã ã«æžã蟌ã¿ãŸãã |
void |
storeToXML(OutputStream os, String comment) |
ãã®è¡šã«å«ãŸãããã¹ãŠã®ããããã£ã衚ãXMLããã¥ã¡ã³ããçºè¡ããŸãã
|
void |
storeToXML(OutputStream os, String comment, String encoding) |
ãã®è¡šã«å«ãŸãããã¹ãŠã®ããããã£ã衚ãXMLããã¥ã¡ã³ãããæå®ããããšã³ã³ãŒãã£ã³ã°ã䜿çšããŠçºè¡ããŸãã
|
Set<String> |
stringPropertyNames() |
ã¡ã€ã³ã»ããããã£ã»ãªã¹ãã«åãååã®ããŒãèŠã€ãããªãå Žåã¯ãããã©ã«ãã®ããããã£ã»ãªã¹ãã«ããåå¥ã®ããŒãå«ããããŒãšããã«å¯Ÿå¿ããå€ãæååã§ãããããªãã®ããããã£ã»ãªã¹ãå
ã®ããŒã®ã»ãããè¿ããŸãã
|
clear, clone, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keys, keySet, merge, put, putAll, putIfAbsent, rehash, remove, remove, replace, replace, replaceAll, size, toString, valuesprotected Properties defaults
public Properties()
public Properties(Properties defaults)
defaults - ããã©ã«ãå€ãpublic Object setProperty(String key, String value)
putãåŒã³åºããŸãã getPropertyã¡ãœãããšå¯Ÿã«ãªããŸãã ããããã£ã®ããŒããã³å€ã«æååã䜿ãããšã矩åä»ããŸãã è¿ãããå€ã¯putãžã®HashtableåŒåºãã®çµæã§ãã key - ããããã£ã»ãªã¹ãã«é
眮ãããããŒãvalue - keyã«å¯Ÿå¿ããå€ãnullãgetProperty(java.lang.String)public void load(Reader reader) throws IOException
Propertiesã¯è¡åäœã§åŠçãããŸãã è¡ã«ã¯èªç¶è¡ãšè«çè¡ã®2çš®é¡ããããŸãã èªç¶è¡ã¯ãè¡æ«èšå·(\nã\rããŸãã¯\r\n)ã®ã»ãããŸãã¯ã¹ããªãŒã ã®æ«å°Ÿã§åºåããã1è¡ã®æååãšããŠå®çŸ©ãããŸãã èªç¶è¡ã¯ã空çœã®è¡ãã³ã¡ã³ãè¡ã§ããããããŒãšèŠçŽ ã®ãã¢ã®å
šéšãŸãã¯äžéšãä¿æããå ŽåããããŸãã è«çè¡ã¯ãããŒãšèŠçŽ ã®ãã¢ã®å
šããŒã¿ãä¿æããŸããããã¯ã¹ã©ãã·ã¥æå\ã䜿çšããŠè¡æ«èšå·ã·ãŒã±ã³ã¹ããšã¹ã±ãŒãããããšã§ã飿¥ããè€æ°ã®èªç¶è¡ã«ãŸãããå ŽåããããŸãã ã³ã¡ã³ãè¡ãããã®æ¹æ³ã§è€æ°è¡ã«ãŸãããããããšã¯ã§ããŸãããåŸè¿°ããããã«ãã³ã¡ã³ãã§ãããã¹ãŠã®èªç¶è¡ã«ã¯ãããããã«ã³ã¡ã³ãã»ã€ã³ãžã±ãŒã¿ãå¿
èŠã§ãã è¡ã¯ãã¹ããªãŒã ã®çµããã«éãããŸã§å
¥åããèªã¿èŸŒãŸããŸãã
ç©ºçœæåã ããå«ãèªç¶è¡ã¯ã空çœãšèŠãªãããŠç¡èŠãããŸãã ã³ã¡ã³ãè¡ã«ã¯ãASCII '#'ãŸãã¯'!'ãæåã®éç©ºçœæåãšããŠå«ãŸããŸããã³ã¡ã³ãè¡ãç¡èŠãããããŒãšèŠçŽ ã®æ
å ±ã¯ãšã³ã³ãŒããããŸããã ãã®ãã©ãŒãããã¯ãè¡çµäºæåã«å ããæåã¹ããŒã¹(' 'ã'\u0020')ãã¿ã('\t'ã'\u0009')ãããã³ãã©ãŒã ã»ãã£ãŒã('\f'ã'\u000C')ã空çœãšèŠãªããŸãã
è«çè¡ãè€æ°ã®èªç¶è¡ã«ãŸãããå Žåãè¡æ«èšå·ã·ãŒã±ã³ã¹ããšã¹ã±ãŒãããããã¯ã¹ã©ãã·ã¥ãè¡æ«èšå·ã·ãŒã±ã³ã¹ãããã³æ¬¡ã®è¡ã®å é ã®ç©ºçœæåã¯ãããŒãŸãã¯èŠçŽ ã®å€ã«äœã®åœ±é¿ãåãŒããŸããã (ããŒãæã®)ããŒãšèŠçŽ ã®æ§æè§£æã«é¢ããæ®ãã®èšè¿°ã§ã¯ãè¡ç¶ç¶æåãåé€ãããããšã§ãããŒãšèŠçŽ ãæ§æãããã¹ãŠã®æåãåäžã®èªç¶è¡ã«è¡šç€ºãããããšãåæãšããŠèª¬æããŸãã è¡æ«èšå·ããšã¹ã±ãŒããããŠãããã©ãããå€å®ããå Žåãè¡æ«èšå·ã·ãŒã±ã³ã¹ã®åã®æåã調ã¹ãã ãã§ã¯ååã§ã¯ãããŸãããè¡æ«èšå·ããšã¹ã±ãŒããããããã«ã¯ãé£ç¶ãã奿°ã®ããã¯ã¹ã©ãã·ã¥ãååšããå¿ èŠããããŸãã å ¥åã¯å·Šããå³ã«åŠçããããããè¡æ«èšå·ã®å(ãŸãã¯ã»ãã®å Žæ)ã«é£ç¶ããããã¯ã¹ã©ãã·ã¥ã2n (ãŒãã§ãªãå¶æ°)åååšããå Žåããšã¹ã±ãŒãåŠçåŸã«nåã®ããã¯ã¹ã©ãã·ã¥ããšã³ã³ãŒããããŸãã
ããŒã«ã¯æåã®éç©ºçœæåãããæåã®ãšã¹ã±ãŒããããŠããªã'='ã':'ããŸãã¯ç©ºçœæåã®æåãŸã§ã®æåãã¹ãŠ(è¡æ«èšå·ãé€ã)ãå«ãŸããŸãã ãããããŒã®çµããã瀺ãæåã¯ãã¹ãŠãããã¯ã¹ã©ãã·ã¥ãåã«ä»ããŠãšã¹ã±ãŒãããããšã§ããŒã«å«ããããšãã§ããŸããããšãã°ã
\:\=
ã«ã¯ã2æåã®ããŒ":="ãå«ãŸããŸãã è¡æ«èšå·ã¯ããšã¹ã±ãŒãã»ã·ãŒã±ã³ã¹\rããã³\nã䜿çšããŠå«ããããšãã§ããŸãã ããŒã®ããšã®ç©ºçœã¯ãã¹ãŠã¹ããããããŸããããŒã«ç¶ãæåã®éç©ºçœæåã'='ãŸãã¯':'ã§ããå Žåãããã¯ç¡èŠããããã®åŸã®ç©ºçœæåããã¹ãŠã¹ããããããŸãã è¡äžã®æ®ãã®ãã¹ãŠã®æåã¯ãé¢é£ä»ããããèŠçŽ æååã®äžéšã«ãªããŸããæ®ãã®æåããªãå Žåããã®èŠçŽ ã¯ç©ºã®æåå""ã§ãã ããŒãšèŠçŽ ãæ§æããçã®æåã·ãŒã±ã³ã¹ãèå¥ããããšããšã¹ã±ãŒãåŠçãåè¿°ã®æ¹æ³ã§å®è¡ãããŸãã
ããšãã°ã次ã®3è¡ã¯ããããããŒ"Truth"ãšãé¢é£ããèŠçŽ å€"Beauty"ã衚ããŸãã
Truth = Beauty Truth:Beauty Truth :BeautyãŸããæ¬¡ã®3è¡ã¯1ã€ã®ããããã£ã衚ããŸãã
fruits apple, banana, pear, \
cantaloupe, watermelon, \
kiwi, mango
ããŒã¯"fruits"ã§ã次ã®èŠçŽ ã«é¢é£ä»ãããããŠããŸãã
"apple, banana, pear, cantaloupe, watermelon, kiwi, mango"æçµçãªçµæã§ã«ã³ãã®ããšã«å¿ ãã¹ããŒã¹ã衚瀺ãããããã«ãå
\ã®åã«ã¹ããŒã¹ããããŸããè¡ã®çµããã瀺ã\ãšãç¶ç¶è¡ã®å
é ã«ãã空çœã¯ç Žæ£ãããã»ãã®æåã«çœ®æãããŸããã
ãŸããæ¬¡ã®3çªç®ã®äŸã§ã¯ãè¡:
cheesesã¯ãããŒã
"cheeses"ã§ãé¢é£ä»ããããŠããèŠçŽ ãç©ºã®æåå""ã§ããããšã衚ããŸãã
ããŒãšèŠçŽ ã«å«ãŸããæåã¯ãæåãªãã©ã«ãæååãªãã©ã«ã§äœ¿çšããããšã¹ã±ãŒãã»ã·ãŒã±ã³ã¹ã«äŒŒãã·ãŒã±ã³ã¹ã§è¡šçŸã§ããŸã(ãJavaâ¢èšèªä»æ§ãã®ã»ã¯ã·ã§ã³3.3ãš3.10.6ãåç §)ã æåããã³æååã§äœ¿çšãããæåãšã¹ã±ãŒãã»ã·ãŒã±ã³ã¹ãUnicodeãšã¹ã±ãŒããšã®éãã¯ã次ã®ãšããã§ãã
\bã¯ãããã¯ã¹ããŒã¹æåã衚ããªãã
\ããšã©ãŒãšããŠåŠçããªããããã¯ã¹ã©ãã·ã¥ã¯èªåçã«åé€ãããã ããšãã°ãJavaæååã«ã·ãŒã±ã³ã¹"\z"ãå«ãŸããŠãããšãã³ã³ãã€ã«æã«ãšã©ãŒãçºçããã ããã«å¯Ÿãããã®ã¡ãœããã¯èªåçã«ããã¯ã¹ã©ãã·ã¥ãåé€ããã ãã®ããããã®ã¡ãœããã§ã¯2æåã®ã·ãŒã±ã³ã¹"\b"ã¯åäžã®æå'b'ãšç䟡ã§ãããšèŠãªãããã
æå®ãããã¹ããªãŒã ã¯ããã®ã¡ãœããã埩垰ããããšãéãããŸãŸã§ãã
reader - å
¥åæåã¹ããªãŒã ãIOException - å
¥åã¹ããªãŒã ããã®èªèŸŒã¿äžã«ãšã©ãŒãçºçããå ŽåãIllegalArgumentException - 圢åŒãäžæ£ãªUnicodeãšã¹ã±ãŒããå
¥åå
ã«çŸããå Žåãpublic void load(InputStream inStream) throws IOException
load(Reader)ã§èŠå®ãããåçŽè¡æåãã©ãŒãããã§ãISO 8859-1æåãšã³ã³ãŒãã£ã³ã°ã䜿çšããããšãåæãããŸããã€ãŸããåãã€ãã¯1ã€ã®Latin1æåã§ãã Latin1ã«ãªãæåãããã³äžéšã®ç¹æ®æåã¯ãããŒãèŠçŽ å
ã§ãJavaâ¢èšèªä»æ§ãã®ã»ã¯ã·ã§ã³3.3ã§å®çŸ©ãããŠããUnicodeãšã¹ã±ãŒãã䜿çšããŠè¡šçŸãããŸãã
æå®ãããã¹ããªãŒã ã¯ããã®ã¡ãœããã埩垰ããããšãéãããŸãŸã§ãã
inStream - å
¥åã¹ããªãŒã ãIOException - å
¥åã¹ããªãŒã ããã®èªèŸŒã¿äžã«ãšã©ãŒãçºçããå ŽåãIllegalArgumentException - å
¥åã¹ããªãŒã ã«åœ¢åŒãäžæ£ãªUnicodeãšã¹ã±ãŒãã»ã·ãŒã±ã³ã¹ãå«ãŸããå Žåã@Deprecated public void save(OutputStream out, String comments)
store(OutputStream out, String comments)ã¡ãœãããŸãã¯storeToXML(OutputStream os, String comment)ã¡ãœããã䜿çšããããšã§ãã store(OutputStream out, String comments)ã¡ãœãããåŒã³åºããã¹ããŒãããIOExceptionãææ¢ããŸããout - åºåã¹ããªãŒã ãcomments - ããããã£ã»ãªã¹ãã®èšè¿°ãClassCastException - ãã®Propertiesãªããžã§ã¯ãã«ãStringsã§ã¯ãªãããŒãŸãã¯å€ãå«ãŸããŠããå Žåãpublic void store(Writer writer, String comments) throws IOException
Properties衚å
ã®ãã®ããããã£ã»ãªã¹ã(ããŒãšèŠçŽ ã®ãã¢)ããload(Reader)ã¡ãœããã䜿çšããã®ã«é©ãã圢åŒã§åºåæåã¹ããªãŒã ã«æžã蟌ã¿ãŸãã
ãã®Properties衚(ååšããå Žå)ã®ããã©ã«ã衚ããã®ããããã£ã¯ããã®ã¡ãœããã«ãã£ãŠæžã蟌ãŸããŸããã
commentsåŒæ°ãnullã§ãªãå Žåã¯ãASCIIæåã®#ãcommentsã®æååãããã³è¡åºåãæåãæåã«åºåã¹ããªãŒã ã«æžã蟌ãŸããŸãã ãã®ãããcommentsã¯èå¥ã³ã¡ã³ããšããŠäœ¿ãããšãã§ããŸãã æ¹è¡(ã\nã)ããã£ãªããžã»ãªã¿ãŒã³(ã\rã)ãæ¹è¡ãçŽåŸã«ç¶ããã£ãªããžã»ãªã¿ãŒã³ãã®ãããããã³ã¡ã³ãå
ã«çŸãããšãããã¯ãWriterã«ãã£ãŠçæããã1åã®è¡åºåãæåã§çœ®ãæããããŸãããããŠãã³ã¡ã³ãå
ã®æ¬¡ã®æåãæå#ã§ãæå!ã§ããªãã£ãå Žåããã®è¡åºåãæåã®ããšã«ASCII #ãæžãåºãããŸãã
次ã«ãASCIIæåã®#ãçŸåšã®æ¥æ(Dateã®toStringã¡ãœããã«ãã£ãŠçŸåšæå»ãçæãããã®ãšåæ§)ãããã³Writerã«ãã£ãŠçæãããè¡åºåãæåãããªãã³ã¡ã³ãè¡ãæžã蟌ãŸããŸãã
ç¶ããŠããã®Properties衚å
ã®ãã¹ãŠã®ãšã³ããªã1è¡ã«1ã€ãã€æžãåºãããŸãã åãšã³ããªã®ããŒæååãASCIIæåã®=ãé¢é£ä»ããããèŠçŽ æååãæžã蟌ãŸããŸãã ããŒã®å Žåããã¹ãŠã®ç©ºçœæåã¯ãåã«\æåãä»ããŠæžã蟌ãŸããŸãã èŠçŽ ã®å Žåãå蟌ã¿ç©ºçœæåã§ãåŸæžãç©ºçœæåã§ããªãå
è¡ç©ºçœæåã¯ãåã«\ãä»ããŠæžã蟌ãŸããŸãã ããŒãšèŠçŽ ã®æå#ã!ã=ãããã³: ã¯ãå¿
ãæ£ããããŒããããããã«ãåã«ããã¯ã¹ã©ãã·ã¥ãä»ããŠæžã蟌ãŸããŸãã
ãšã³ããªãæžã蟌ãŸããããšã§ãåºåã¹ããªãŒã ããã©ãã·ã¥ãããŸãã åºåã¹ããªãŒã ã¯ãã®ã¡ãœãããã埩垰ããããšãéãããŸãŸã§ãã
writer - åºåæåã¹ããªãŒã ã»ã©ã€ã¿ãŒãcomments - ããããã£ã»ãªã¹ãã®èšè¿°ãIOException - æå®ãããåºåã¹ããªãŒã ãžã®ãã®ããããã£ã»ãªã¹ãã®æžèŸŒã¿æã«IOExceptionãã¹ããŒãããå ŽåãClassCastException - ãã®Propertiesãªããžã§ã¯ãã«ãStringsã§ã¯ãªãããŒãŸãã¯å€ãå«ãŸããŠããå ŽåãNullPointerException - writerãnullã§ããå Žåãpublic void store(OutputStream out, String comments) throws IOException
Properties衚å
ã®ãã®ããããã£ã»ãªã¹ã(ããŒãšèŠçŽ ã®ãã¢)ããload(InputStream)ã¡ãœããã䜿çšããŠProperties衚ã«ããŒãããã®ã«é©ãã圢åŒã§åºåã¹ããªãŒã ã«æžã蟌ã¿ãŸãã
ãã®Properties衚(ååšããå Žå)ã®ããã©ã«ã衚ããã®ããããã£ã¯ããã®ã¡ãœããã«ãã£ãŠæžã蟌ãŸããŸããã
ãã®ã¡ãœããã¯ãã³ã¡ã³ãããã³ããããã£ã®ããŒãšå€ããstore(Writer)ã§èŠå®ãããã®ãšåã圢åŒã§åºåããŸãããã ããæ¬¡ã®ç¹ãç°ãªããŸãã
\uxxxxãšããŠæžã蟌ãŸããã
\u0020ããå°ããæåããã³\u007Eãã倧ããæåã¯ãé©åãª16é²å€xxxxã䜿çšããŠ\uxxxxãšããŠæžã蟌ãŸããã
ãšã³ããªãæžã蟌ãŸããããšã§ãåºåã¹ããªãŒã ããã©ãã·ã¥ãããŸãã åºåã¹ããªãŒã ã¯ãã®ã¡ãœãããã埩垰ããããšãéãããŸãŸã§ãã
out - åºåã¹ããªãŒã ãcomments - ããããã£ã»ãªã¹ãã®èšè¿°ãIOException - æå®ãããåºåã¹ããªãŒã ãžã®ãã®ããããã£ã»ãªã¹ãã®æžèŸŒã¿æã«IOExceptionãã¹ããŒãããå ŽåãClassCastException - ãã®Propertiesãªããžã§ã¯ãã«ãStringsã§ã¯ãªãããŒãŸãã¯å€ãå«ãŸããŠããå ŽåãNullPointerException - outãnullã§ããå Žåãpublic void loadFromXML(InputStream in) throws IOException, InvalidPropertiesFormatException
XMLããã¥ã¡ã³ãã«ã¯ã次ã®DOCTYPE宣èšãå¿ èŠã§ãã
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">ããã«ãããã¥ã¡ã³ãã¯åè¿°ã®ããããã£DTDãæºããå¿ èŠããããŸãã
å®è£
ã¯ãUTF-8ãŸãã¯UTF-16ãšã³ã³ãŒãã£ã³ã°ã䜿çšããXMLããã¥ã¡ã³ããèªã¿åãå¿
èŠããããŸãã å®è£
ã¯è¿œå ã®ãšã³ã³ãŒãã£ã³ã°ããµããŒãã§ããŸãã
ãã®ã¡ãœãããæ»ããšãæå®ãããã¹ããªãŒã ãéããããŸãã
in - XMLããã¥ã¡ã³ãã®èªèŸŒã¿å
ã®å
¥åã¹ããªãŒã ãIOException - æå®ãããå
¥åã¹ããªãŒã ããã®èªèŸŒã¿æã«IOExceptionãçºçããå ŽåãUnsupportedEncodingException - ããã¥ã¡ã³ãã®ãšã³ã³ãŒãã£ã³ã°å®£èšãèªã¿åãããšãã§ããããã«ãµããŒããããŠããªããšã³ã³ãŒãã£ã³ã°ãæå®ãããŠããå ŽåInvalidPropertiesFormatException - å
¥åã¹ããªãŒã äžã®ããŒã¿ããèŠæ±ãããããã¥ã¡ã³ãåãæã€æå¹ãªXMLããã¥ã¡ã³ãã«ãªããªãå ŽåãNullPointerException - inãnullã§ããå ŽåãstoreToXML(OutputStream, String, String)ãCharacter Encoding in Entitiespublic void storeToXML(OutputStream os, String comment) throws IOException
ãã®ã¡ãœãããprops.storeToXML(os, comment)ã®åœ¢åŒã§åŒã³åºããå Žåãprops.storeToXML(os, comment, "UTF-8");ã®åŒã³åºããšåãçµæãåŸãããŸãã
os - XMLããã¥ã¡ã³ãã®çºè¡å
ã®åºåã¹ããªãŒã comment - ããããã£ã»ãªã¹ãã®èšè¿°ãã³ã¡ã³ããå¿
èŠãªãå Žåã¯nullãIOException - æå®ãããåºåã¹ããªãŒã ãžã®æžèŸŒã¿æã«IOExceptionãçºçããå ŽåãNullPointerException - osãnullã§ããå ŽåãClassCastException - ãã®Propertiesãªããžã§ã¯ãã«ãStringsã§ã¯ãªãããŒãŸãã¯å€ãå«ãŸããŠããå ŽåãloadFromXML(InputStream)public void storeToXML(OutputStream os, String comment, String encoding) throws IOException
ãã®XMLããã¥ã¡ã³ãã§ã¯ã次ã®DOCTYPEã宣èšãããŸãã
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
æå®ãããã³ã¡ã³ããnullã®å Žåãããã¥ã¡ã³ãã«ã³ã¡ã³ãã¯æ ŒçŽãããŸããã
å®è£
ã¯ãUTF-8ãŸãã¯UTF-16ãšã³ã³ãŒãã£ã³ã°ã䜿çšããXMLããã¥ã¡ã³ãã®æžèŸŒã¿ããµããŒãããå¿
èŠããããŸãã å®è£
ã¯è¿œå ã®ãšã³ã³ãŒãã£ã³ã°ããµããŒãã§ããŸãã
æå®ãããã¹ããªãŒã ã¯ããã®ã¡ãœããã埩垰ããããšãéãããŸãŸã§ãã
os - XMLããã¥ã¡ã³ãã®çºè¡å
ã®åºåã¹ããªãŒã comment - ããããã£ã»ãªã¹ãã®èšè¿°ãã³ã¡ã³ããå¿
èŠãªãå Žåã¯nullãencoding - ãµããŒããããæåãšã³ã³ãŒãã£ã³ã°ã®ååIOException - æå®ãããåºåã¹ããªãŒã ãžã®æžèŸŒã¿æã«IOExceptionãçºçããå ŽåãUnsupportedEncodingException - ãšã³ã³ãŒãã£ã³ã°ãå®è£
ã«ãã£ãŠãµããŒããããªãå ŽåãNullPointerException - osãnullããŸãã¯encodingãnullã®å ŽåãClassCastException - ãã®Propertiesãªããžã§ã¯ãã«ãStringsã§ã¯ãªãããŒãŸãã¯å€ãå«ãŸããŠããå ŽåãloadFromXML(InputStream)ãCharacter Encoding in Entitiespublic String getProperty(String key)
nullãè¿ãããŸãã key - ããããã£ã»ããŒsetProperty(java.lang.String, java.lang.String), defaultspublic String getProperty(String key, String defaultValue)
key - ããã·ã¥è¡šããŒãdefaultValue - ããã©ã«ãå€ãsetProperty(java.lang.String, java.lang.String), defaultspublic Enumeration<?> propertyNames()
ClassCastException - æååã§ãªãããŒããã®ããããã£ã»ãªã¹ãå
ã«ååšããå ŽåãEnumeration, defaults, stringPropertyNames()public Set<String> stringPropertyNames()
è¿ãããã»ããã¯ãPropertiesãªããžã§ã¯ãã«é¢é£ä»ããããŠããŸããã ãã®Propertiesãžã®å€æŽã¯ã»ããã«ã¯åæ ãããŸããããã®éãåæ§ã§ãã
defaultspublic void list(PrintStream out)
out - åºåã¹ããªãŒã ãClassCastException - æååã§ãªãããŒããã®ããããã£ã»ãªã¹ãå
ã«ååšããå Žåãpublic void list(PrintWriter out)
out - åºåã¹ããªãŒã ãClassCastException - æååã§ãªãããŒããã®ããããã£ã»ãªã¹ãå
ã«ååšããå Žåã ãã°ãŸãã¯æ©èœãéä¿¡
詳现ãªAPIãªãã¡ã¬ã³ã¹ããã³éçºè
ããã¥ã¡ã³ãã«ã€ããŠã¯ãJava SEã®ããã¥ã¡ã³ããåç
§ããŠãã ããã ãã®ããã¥ã¡ã³ãã«ã¯ãæŠå¿µçãªæŠèŠãçšèªã®å®çŸ©ãåé¿æ¹æ³ãæå¹ãªã³ãŒãäŸãªã©ã®ãéçºè
ã察象ã«ãããã詳现ãªèª¬æãå«ãŸããŠããŸãã
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyãåç
§ããŠãã ããã