Получение файла JPEG в виде массива байтов

В этом разделе рассматривается добавление нескольких закрытых методов в тело класса FlowerService. Эти методы принимают имя изображения цветка, создают путь к файлу JPEG цветка и возвращают двоичное представление файла JPEG (массив байтов). В последующих разделах описывается создание кода для общедоступных операций веб-служб, чтобы операции могли вызывать эти закрытые методы.

1. Откройте представление Source ("Исходный код") проекта. Необходимо добавить код, который принимает имя изображения, создает путь к изображению на основе этого имени и представляет изображение в виде массива байтов. Введите или вставьте в тело класса FlowerService следующий код:

   private byte[] getFlowerBytes(String name) throws IOException {
       URL resource = this.getClass().getResource("/org/flower/resources/"+name+".jpg");
       return getBytes(resource);
   }

2. Появится предупреждение о том, что среде IDE не удается найти URL-адрес. Добавьте оператор импорта для java.net.URL, вручную или путем нажатия Ctrl-Shift-I (⌘-Shift-I в Mac).
3. Появится новое предупреждение. В предупреждении сообщается о том, что среде IDE не удается найти метод getBytes. Щелкните значок предупреждения левой кнопкой мыши и щелкните всплывающую подсказку для создания метода getBytes.
   
4. В окне редактора будет выполнен переход к только что созданному методу getBytes. Добавьте в метод следующий код. Этот код служит для установки подключения к URL-адресу, переданному от метода getFlowerBytes, и возврата элемента InputStream. Затем код считывает входной поток порциями по 1024 байта, сохраняет байты в буфере массива данных и записывает ByteArrayOutputStream на основе содержимого буфера.

   private byte[] getBytes(URL resource) throws IOException {
       InputStream in = resource.openStream();
       ByteArrayOutputStream bos = new ByteArrayOutputStream();
       byte[] buf = new byte[1024];
       for(int read; (read = in.read(buf)) != -1;) {
           bos.write(buf, 0, read);
       }
       return bos.toByteArray();
   }

5. Добавьте операторы импорта для java.io.InputStream и java.io.ByteArrayOutputStream.

Чтение массива байтов как изображения

В этом разделе рассматривается добавление закрытого метода в тело класса FlowerService. Этот метод принимает массив байтов, представляющих файл JPEG, и возвращает объект java.awt.Image. Обратите внимание, что массив байтов создается посредством метода getBytes(URL), создание которого изучалось в разделе Получение файла JPEG в виде массива байтов.

1. Добавьте в тело класса FlowerService закрытый метод getImage. Возвращаемым типом метода getImage является Image. Метод принимает два параметра. Первым параметром является массив байтов, созданный посредством метода getBytes. Вторым параметром является булево значение, указывающее, является ли изображение эскизом. Метод getImage выдает исключение IOException.

   private Image getImage(byte[] bytes, boolean isThumbnail) throws IOException {
       }

2. Добавьте в тело метода getImage строку, которая создает объект ByteArrayInputStream из массива байтов, принимаемого методом в качестве параметра.

   ByteArrayInputStream bis = new ByteArrayInputStream(bytes);

3. Добавьте строку для создания элемента Object на основе объекта ByteArrayInputStream.

   Object source = bis;

4. Добавьте строку для создания объекта ImageInputStream из общего объекта Object.

   ImageInputStream iis = ImageIO.createImageInputStream(source);

5. Добавьте строку для создания элемента Iterator для всех зарегистрированных в настоящее время объектов ImageReader в целях расшифровки файлов JPEG.

   Iterator readers = ImageIO.getImageReadersByFormatName("jpeg");

6. Добавьте строку для создания объекта ImageReader для следующего элемента в Iterator.

   ImageReader reader = (ImageReader) readers.next();

7. Добавьте строки для создания параметров считывания изображения по умолчанию, однако если объект Image представляет эскиз, добавьте код субдискретизации с шагом 4.

   ImageReadParam param = reader.getDefaultReadParam();
   if (isThumbnail) {
       param.setSourceSubsampling(4, 4, 0, 0);
   }

8. Добавьте код, использующий объект ImageReader для чтения объекта ImageInputStream и возврата элемента Image на основе этого объекта, а также параметров чтения изображения.

   reader.setInput(iis, true);
   return reader.read(0, param);

9. Нажмите Ctrl-Shift-I (⌘-Shift-I в MacOS). Откроется диалоговое окно Fix All Imports ("Исправление всех операторов импорта"). Примите настройку по умолчанию диалогового окна "Исправление всех операторов импорта" и нажмите кнопку "ОК".
   

Метод getImage готов.

private Image getImage(byte[] bytes, boolean isThumbnail) throws IOException {
    ByteArrayInputStream bis = new ByteArrayInputStream(bytes);
    Object source = bis; // File or InputStream
    ImageInputStream iis = ImageIO.createImageInputStream(source);
    Iterator readers = ImageIO.getImageReadersByFormatName("jpeg");
    ImageReader reader = (ImageReader) readers.next();
    ImageReadParam param = reader.getDefaultReadParam();
    if (isThumbnail) {
        param.setSourceSubsampling(4, 4, 0, 0);
    }
    reader.setInput(iis, true);
    return reader.read(0, param);
}

Реализация метода getFlower

Добавьте следующий код реализации в метод getFlower() для получения цветка по его имени и возврата изображения этого цветка. Обратите внимание, что это код вызывает метод getFlowerBytes(name) для получения файла JPEG в виде массива байтов. Затем код вызывает закрытый метод getImage для возврата массива байтов в виде объекта Image.

@WebMethod(operationName = "getFlower")
public Image getFlower(@WebParam(name = "name") String name) throws IOException {
    byte[] bytes = getFlowerBytes(name);
    return getImage(bytes, false);
}

Создание списка массивов байтов для всех файлов JPEG

1. В верхней части тела класса FlowerService создайте массив строк с названиями всех цветов.

   private static final String[] FLOWERS = {"aster", "honeysuckle", "rose", "sunflower"};

2. Добавьте метод для создания объекта ArrayList и добавления массива байтов для каждого цветка в список List.

   private List allFlowers() throws IOException {
       List flowers = new ArrayList();
       for (String flower:FLOWERS) {
           URL resource = this.getClass().getResource("/org/flower/resources/"+flower+".jpg");
           flowers.add(getBytes(resource));
       }
       return flowers;
   }

3. Добавьте операторы импорта для java.util.ArrayList и java.util.List.

Реализация метода getThumbnails

Измените метод getThumbnails() следующим образом. Обратите внимание на добавление кода реализации и изменение типа возврата с List на List<Image>. Также учтите, что булево значения isThumbnail true передается в метод getImage. Код реализации метода getThumbnails вызывает метод allFlowers, чтобы создать список массивов байтов для всех файлов JPEG. Метод getThumbnails затем создает список List объектов Image и вызывает метод getImage для каждого цветка с целью возврата массива байтов для этого цветка в качестве объекта Image и добавления объекта Image в объект List.

@WebMethod(operationName = "getThumbnails")
public List<Image> getThumbnails() throws IOException {
    List<byte[]> flowers = allFlowers();
    List<Image> flowerList = new ArrayList<Image>(flowers.size());
    for (byte[] flower : flowers) {
        flowerList.add(getImage(flower, true));
    }
    return flowerList;
}