javaStruct - 通讯协议的解封包第三方库--（二）官方文档三

原文链接

https://code.google.com/archive/p/javastruct/wikis/example_photoshop_acb_file_reader_writer.wiki

翻译用工具

翻译使用的是个人免费版Transmate

译文

如何使用JavaStruct读写Adobe Photoshop Color book文件
JavaStruct对于读写特定的二进制文件也是非常理想的。在这个例子中，我们将写一个 Photoshop Color book 文件读写器。这种文件格式的细节可在这里找到。
完整的代码请到：http://javastruct.googlecode.com/svn/trunk/javastruct/samples/photoshop/
备注：我注意到使用一个nio ByteBuffer写这样一个读写器并不是非常困难(可能更短)。但是JavaStruct提供了更清晰，可维护性更好的代码。并且如果有许多的二进制文件或消息，处理解封包将是非常容易引入错误的。

文件头
在头部，有一个特定的字符串字段. ±-------±----------------------//----------------------------------------+ | Length | UTF-16 Characters \ | ±-------±----------------------//----------------------------------------+
这样首先我们需要将这些字符串用一个特别的结构类表示，姑且叫 A 结构体。我们使用数组长度标记来声明。

@StructClass 
public class AString { 
  @StructField (order = 0 ) 
  @ArrayLengthMarker (fieldName = "chars") 
  public int length; 

  @StructField (order = 1) 
  public char[] chars;

  public AString(String content){ 
    this.length = content.length(); 
    this.chars = content.toCharArray(); 
  } 
  ... 
}

下面是实际的头。

@StructClass 
public class ACBHeader { 
  public static final short RGB = 0; 
  public static final short CMYK = 2; 
  public static final short LAB = 7; 

  // 签名通常是ASCII字符串“8BCB"
  @StructField (order = 0) 
  public byte[] signature = {'8', 'B', 'C', 'B'}; 

  //Photoshop 7 仅打开版本为1(0x0001)的文件
  @StructField (order = 1) 
  public short fileVersion; 

  // 唯一识别符
  @StructField (order = 2) 
  public short colorBookIdentifier; 

  @StructField (order = 3) 
  public AString title; 

  @StructField (order = 4) 
  public AString colorNamePrefix; 

  @StructField (order = 5) 
  public AString colorNamePostfix; 

  // 通常是一个版权声明
  @StructField (order = 6) 
  public AString description; 

  @StructField (order = 7) 
  public short colorCount; 

  // Photoshop 每页显示颜色数.这个字段指定了
  // 能够在一个页面上显示的颜色的最大数量. 
  @StructField (order = 8) 
  public short colorsPerPage; 

  @StructField (order = 9) 
  public short pageSelectorOffset; 

  // RGB, CMYK or Lab 
  @StructField (order = 10) 
  public short colorSpaceID; 
  ... 

读取颜色
这里是比较棘手的部分。通过格式化，颜色值和它的格式是依赖于 colorSpaceID 字段。其可以是RGB,CMYK或者Lab。这样我们对每一个颜色域写一个类。这里有颜色数据的”colorCount"数量值。

@StructClass 
public class RGBColor{ 
  @StructField (order = 0) 
  public AString name; 

  @StructField (order = 1) 
  public byte[] code = new byte[6]; 

  @StructField (order = 2) 
  public byte red; 

  @StructField (order = 3) 
  public byte green; 

  @StructField (order = 4) 
  public byte blue; 
  ... 
} 

@StructClass 
public class LabColor { 
  @StructField (order = 0) 
  public AString name; 

  @StructField (order = 1) 
  public byte[] code = new byte[6]; 

  @StructField (order = 2) 
  public byte lightness; 

  @StructField (order = 3) 
  public byte aChrom; 

  @StructField (order = 4) 
  public byte bChrom; 
  ... 
} 

注意对于每个颜色类都包含名字和编码字段。这是必要的，因为当前结构体类并不是从一个结构体基类派生的。

读写器
为了读和写acb文件，我们初始化了包含FileStream的StructPacker和StructUnpacker类。之后，读文件头和颜色值就直截了当。

public class AdobeColorBook { 
  ACBHeader header;
  RGBColor[] rgbColors = null; 
  CMYKColor[] cmykColors = null; 
  LabColor[] labColors = null; 
  
  public void read(String acbFile){ 
    try { 
      FileInputStream fis = new FileInputStream(new File(acbFile)); 
      header = new ACBHeader(); 
      StructUnpacker up = JavaStruct.getUnpacker(fis, ByteOrder.BIG_ENDIAN); 
      up.readObject(header); 
      switch(header.ColorSpaceID){ 
        case ACBHeader.RGB : 
          rgbColors = new RGBColor[header.colorCount]; 
          for(int i=0; i<header.colorCount; i++){ 
            rgbColors[i] = new RGBColor(); 
            up.readObject(rgbColors[i]); 
          } 
      break; 
      
      case ACBHeader.CMYK : 
        cmykColors = new CMYKColor[header.colorCount]; 
        for(int i=0; i<header.colorCount; i++){ 
          cmykColors[i] = new CMYKColor(); 
          up.readObject(cmykColors[i]); 
        } 
      break; 
      
      case ACBHeader.LAB : 
        labColors = new LabColor[header.colorCount]; 
        for(int i=0; i<header.colorCount; i++){ 
          labColors[i] = new LabColor(); 
          up.readObject(labColors[i]); 
        } 
      break; 
      default: 
    } 
    } catch (FileNotFoundException e) { 
      e.printStackTrace(); 
    } catch (StructException e) { 
      e.printStackTrace(); 
    } 
  } 

  public void write(String name){ 
    try{ 
      FileOutputStream fo = new FileOutputStream(new File(name)); 
      StructPacker packer = JavaStruct.getPacker(fo, ByteOrder.BIG_ENDIAN); 
      packer.writeObject(header); 
      switch(header.ColorSpaceID){ 
        case ACBHeader.RGB : 
          for(RGBColor color : rgbColors){ 
            packer.writeObject(color); 
          } 
        break; 
        case ACBHeader.CMYK : 
          for(CMYKColor color : cmykColors){ 
            packer.writeObject(color); 
          } 
        break; 
        case ACBHeader.LAB : 
          for(LabColor color : labColors){ 
            packer.writeObject(color); 
          } 
        break; 
        default: 
        } 
      fo.close(); 
      } catch(StructException e){ 
        e.printStackTrace(); 
      } catch (IOException e) { 
        e.printStackTrace(); 
      } 
    } 

  public String toString(){ 
    String str = ""; 
    if (header != null){ 
      str += header; 
    } 
    switch(header.ColorSpaceID){ 
      case ACBHeader.RGB : 
        for(RGBColor color : rgbColors) { 
          str += color + "\n"; 
        } 
      break; 
      case ACBHeader.CMYK : 
        for(CMYKColor color : cmykColors) { 
          str += color + "\n"; 
        } 
      break; 
      case ACBHeader.LAB : 
        for(LabColor color : labColors) { 
          str += color + "\n"; 
        } 
      break; 
    } 
    return str; 
  } 

  public static void main(String[] args) { 
    AdobeColorBook anpaBook = new AdobeColorBook(); 
    anpaBook.read("ANPA Color.acb"); 
    anpaBook.write("ANPA_my_Color.acb"); 
    System.out.println(anpaBook); 
  } 
}