Пакет java.util

Класс Properties

Класс Properties предназначен для хранения набора свойств (параметров). Методы

String getProperty(String key)
String getProperty(String key,
                   String defaultValue)

позволяют получить свойство из набора.

С помощью метода setProperty(String key, String value) это свойство можно установить.

Метод load(InputStream inStream) позволяет загрузить набор свойств из входного потока (потоки данных подробно рассматриваются в лекции 15). Как правило, это текстовый файл, в котором хранятся параметры. Параметры - это строки, которые представляют собой пары ключ/значение. Предполагается, что по умолчанию используется кодировка ISO 8859-1. Каждая строка должна оканчиваться символами \r,\n или \r\n. Строки из файла будут считываться до тех пор, пока не будет достигнут его конец. Строки, состоящие из одних пробелов, или начинающиеся со знаков ! или #, игнорируются, т.е. их можно трактовать как комментарии. Если строка оканчивается символом /, то следующая строка считается ее продолжением. Первый символ с начала строки, отличный от пробела, считается началом ключа. Первый встретившийся пробел, двоеточие или знак равенства считается окончанием ключа. Все символы окончания ключа при необходимости могут быть включены в название ключа, но при этом перед ними должен стоять символ \. После того, как встретился символ окончания ключа, все аналогичные символы будут проигнорированы до начала значения. Оставшаяся часть строки интерпретируется как значение. В строке, состоящей только из символов \t, \n, \r, \\, \", \', \ и \uxxxx, они все распознаются и интерпретируются как одиночные символы. Если встретится сочетание \ и символа конца строки, то следующая строка будет считаться продолжением текущей, также будут проигнорированы все пробелы до начала строки-продолжения.

Метод save(OutputStream inStream,String header) сохраняет набор свойств в выходной поток в виде, пригодном для вторичной загрузки с помощью метода load. Символы, считающиеся служебными, кодируются так, чтобы их можно было считать при вторичной загрузке. Символы в национальной кодировке будут приведены к виду \uxxxx. При сохранении используется кодировка ISO 8859-1. Если указан header, то он будет помещен в начало потока в виде комментария (т.е. с символом # в начале), далее будет следовать комментарий, в котором будет указано время и дата сохранения свойств в потоке.

В классе Properties определен еще метод list(PrintWriter out), который практически идентичен save. Отличается лишь заголовок, который изменить нельзя. Кроме того, строки усекаются по ширине. Поэтому данный метод для сохранения Properties не годится.

public class Test {
   public Test() {
   }
   public static void main(String[] args) {
      Test test = new Test();
      Properties props = new Properties();
      StringWriter sw = new StringWriter();
      sw.write("Key1 = Value1 \n");
      sw.write(" Key2 : Value2 \r\n");
      sw.write(" Key3 Value3 \n ");
      InputStream is = new ByteArrayInputStream(sw.toString().getBytes());

      try {
         props.load(is);
      }
      catch (IOException ex) {
         ex.printStackTrace();
      }
      props.list(System.out);
      props.setProperty("Key1","Modified Value1");
      props.setProperty("Key4","Added Value4");
      props.list(System.out);
   }
}

Результатом будет:

-- listing properties --
Key3=Value3 
Key2=Value2 
Key1=Value1 

-- listing properties --
Key4=Added Value4
Key3=Value3 
Key2=Value2 
Key1=Modified Value1

Интерфейс Comparator

В коллекциях многие методы сортировки или сравнения требуют передачи в качестве одного из параметров объекта, который реализует интерфейс Comparator. Этот интерфейс определяет единственный метод compare(Object obj1,Object obj2), который на основании определенного пользователем алгоритма сравнивает объекты, переданные в качестве параметров. Метод compare должен вернуть:

-1 если obj1 < obj2
0 если obj1 = obj2
1 если obj1 > obj2

Класс Arrays

Класс Arrays обеспечивает набор методов для выполнения операций над массивами, таких, как поиск, сортировка, сравнение. В Arrays также определен статический метод public List asList(a[] arr), который возвращает список фиксированного размера, основанный на массиве. Изменения в List можно внести, изменив данные в массиве.

public class Test {
   public Test() {
   }
   public static void main(String[] args) {
      Test test = new Test();
      String[] arr = {"String 1","String 4",
                      "String 2","String 3"};
      test.dumpArray(arr);
      Arrays.sort(arr);
      test.dumpArray(arr);
      int ind = Arrays.binarySearch(arr,
                  "String 4");
      System.out.println(
        "\nIndex of \"String 4\" = " + ind);
   }
   void dumpArray(String arr[]){
      System.out.println();
      for(int cnt=0;cnt < arr.length;cnt++) {
         System.out.println(arr[cnt]);
      }
   }
}

Класс StringTokenizer

Этот класс предназначен для разбора строки по лексемам ( tokens ). Строка, которую необходимо разобрать, передается в качестве параметра конструктору StringTokenizer(String str). Определено еще два перегруженных конструктора, которым дополнительно можно передать строку-разделитель лексем StringTokenizer(String str, String delim) и признак возврата разделителя лексем StringTokenizer(String str, String delim, Boolean returnDelims).

Разделителем лексем по умолчанию служит пробел.

public class Test {

   public Test() {
   }
   public static void main(String[] args) {
      Test test = new Test();
      String toParse = 
         "word1;word2;word3;word4";
      StringTokenizer st = 
         new StringTokenizer(toParse,";");
      while(st.hasMoreTokens()){
         System.out.println(st.nextToken());
      }
   }
}

Результатом будет:

word1
word2
word3
word4

Класс BitSet

Класс BitSet предназначен для работы с последовательностями битов. Каждый компонент этой коллекции может принимать булево значение, которое обозначает, установлен бит или нет. Содержимое BitSet может быть модифицировано содержимым другого BitSet с использованием операций AND, OR или XOR (исключающее или).

BitSet имеет текущий размер (количество установленных битов), может динамически изменяться. По умолчанию все биты в наборе устанавливаются в 0 (false). Установка и очистка битов в BitSet осуществляется методами set(int index) и clear(int index).

Метод int length() возвращает "логический" размер набора битов, int size() возвращает количество памяти, занимаемой битовой последовательностью BitSet.

public class Test {

   public Test() {
   }
   public static void main(String[] args) {
      Test test = new Test();
      BitSet bs1 = new BitSet();
      BitSet bs2 = new BitSet();
      bs1.set(0);
      bs1.set(2);
      bs1.set(4);
      System.out.println("Length = " + 
         bs1.length()+" size = "+bs1.size());
      System.out.println(bs1);
      bs2.set(1);
      bs2.set(2);
      bs1.and(bs2);
      System.out.println(bs1);
   }
}

Результатом будет:

Length = 5 size = 64
{0, 2, 4}
{2}

Проанализировав первую строку вывода на консоль, можно сделать вывод, что для внутреннего представления BitSet использует значения типа long.

Класс Random

Класс Random используется для получения последовательности псевдослучайных чисел. В качестве "зерна" применяется 48-битовое число. Если для инициализации Random задействовать одно и то же число, будет получена та же самая последовательность псевдослучайных чисел.

В классе Random определено также несколько методов, которые возвращают псевдослучайные величины для примитивных типов Java.

Дополнительно следует отметить наличие двух методов: double nextGaussian() - возвращает случайное число в диапазоне от 0.0 до 1.0 распределенное по нормальному закону, и void nextBytes(byte[] arr) - заполняет массив arr случайными величинами типа byte.

Пример использования Random:

public class Test {
   public Test() {
   }
   public static void main(String[] args) {
      Test test = new Test();
      Random r = new Random(100);
      // Generating the same sequence numbers
      for(int cnt=0;cnt<9;cnt++){
         System.out.print(r.nextInt() + " ");
      }
      System.out.println();
      r = new Random(100);
      for(int cnt=0;cnt<9;cnt++) {
         System.out.print(r.nextInt() + " ");
      }
      System.out.println();
      // Generating sequence of bytes
      byte[] randArray = new byte[8];
      r.nextBytes(randArray);
      test.dumpArray(randArray);
   }
   void dumpArray(byte[] arr) {
      for(int cnt=0;cnt< arr.length;cnt++) {
         System.out.print(arr[cnt]);
      }
      System.out.println();
   }
}

Результатом будет:

-1193959466 -1139614796 837415749 -1220615319 -1429538713 118249332 -951589224 -1193959466 
-1139614796 837415749 -1220615319 -1429538713 118249332 -951589224 81;-6;-107;77;118;17;93;
-98;