.properties

Материал из Википедии — свободной энциклопедии
Перейти к: навигация, поиск
Properties
Расширение

.properties

MIME-тип

text/plain

Тип формата

ASCII

.properties — текстовый формат и одноимённое расширение имени файла. Применяется для хранения конфигурационных параметров прикладного ПО (пар «ключ» — «значение»).

Описание формата[править | править вики-текст]

Файлы с расширением «.properties» являются обычными текстовыми файлами. Отображать и изменять такие файлы способен любой текстовый редактор.

О кодировке текста см. ниже.

Файлы содержат пары «имя параметра» — «значение», разделённые знаком равенства «=», двоеточием «:» или пробелом « ». Каждая пара записывается на отдельной строке. «Имя параметра» (ключ) и «значение» — строки (тип). Пример:

key=value
key = value
key:value
key value

website = http\://ru.wikipedia.org/
language = Russian

«website» и «language» — имена параметров, а «http://ru.wikipedia.org/» и «Russian» — их значения.

Комментарии начинаются с символа решётки «#» или знака восклицания «!».

# Это комментарий
! Это тоже комментарий.

Для записи служебных символов («#», «!», « », «=», символа перевода строки) внутри «имени параметра» или «значения» их необходимо экранировать с помощью символа обратной косой черты «\».

Так с помощью «\» значение может быть записано на нескольких строках.

# Обратная косая черта указывает на то, что значение параметра продолжается со следующей строки.

message = Добро пожаловать в \
          Википедию\!

Параметр «message» будет иметь значение «Добро пожаловать в Википедию!» (с восклицательным знаком «!»). Обратите внимание, что символы пробелов « » не были экранированы, поэтому были удалены.

«Имя параметра» (ключ) может содержать пробелы, но они должны экранироваться символом «\».

# Добавление пробелов в имя параметра
key\ with\ spaces = Это значение, 
доступное по ключу "key with spaces".

Также имеется поддержка Юникода.

# Юникод
tab : \u0009

Кодировка[править | править вики-текст]

Стандартная кодировка файла — ISO-8859-1, также известная как «Latin-1». Любые символы, не входящие в состав «Latin-1», должны записываться в виде «\uHHHH», где «HHHH» — уникальный номер символа (англ. code point) в стандарте Unicode, записанный в шестнадцатеричной системе счисления.

Для преобразования символов Юникода в вид «\uHHHH» созданы специальные утилиты:

  • native2ascii (поставляется в комплекте с JDK);
  • po2prop (написанна на языке Python и доступна по лицензии GPLv2)[1].

Для локализации программ, написанных на Java, можно использовать другие решения:

  • файлы в формате «XML Properties» (формат доступен в JDK начиная с версии Java 1.5 и по умолчанию использует кодировку UTF-8)[2];
  • создать реализацию custom control, предоставляющую поддержку любой кодировки[3].

Adobe Flex хранит файлы «.properties» в кодировке UTF-8[4].

Применение[править | править вики-текст]

Примечания[править | править вики-текст]

Ссылки[править | править вики-текст]