Prepared for releasec

Author: phax

README.md

@@ -36,5 +36,5 @@ Add the following to your pom.xml to use this artifact, replacing `x.y.z` with t
 
 # News and Noteworthy
 
-* v0.1.0 - 2024-01-30
+* v0.1.0 - 2024-01-31
     * Initial version

src/main/java/com/helger/phive/binary/impl/FileFormatDescriptorJPG.java

@@ -0,0 +1,56 @@
+/*
+ * Copyright (C) 2024 Philip Helger (www.helger.com)
+ * philip[at]helger[dot]com
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *         http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.helger.phive.binary.impl;
+
+import java.util.Map;
+
+import javax.annotation.Nonnull;
+
+import com.helger.commons.collection.ArrayHelper;
+import com.helger.commons.collection.impl.CommonsArrayList;
+import com.helger.commons.collection.impl.CommonsHashMap;
+import com.helger.commons.mime.CMimeType;
+import com.helger.phive.binary.AbstractFileFormatDescriptor;
+import com.helger.phive.binary.EPhiveContentValidationMode;
+import com.helger.phive.binary.IPhiveContentValidator;
+
+/**
+ * File format descriptor for JPG/JPEG
+ *
+ * @author Philip Helger
+ */
+public class FileFormatDescriptorJPG extends AbstractFileFormatDescriptor
+{
+  private static final byte [] MIME_ID_JPG = { (byte) 0xff, (byte) 0xd8 };
+
+  @Nonnull
+  private static Map <EPhiveContentValidationMode, IPhiveContentValidator> _getContentValidators ()
+  {
+    final Map <EPhiveContentValidationMode, IPhiveContentValidator> ret = new CommonsHashMap <> ();
+    ret.put (EPhiveContentValidationMode.LEADING_BYTES, data -> ArrayHelper.startsWith (data, MIME_ID_JPG));
+    return ret;
+  }
+
+  public FileFormatDescriptorJPG ()
+  {
+    super ("JPEG image",
+           "JPEG",
+           new CommonsArrayList <> ("jpg", "jpeg"),
+           new CommonsArrayList <> (CMimeType.IMAGE_JPG.getAsString ()),
+           _getContentValidators ());
+  }
+}

src/main/java/com/helger/phive/binary/impl/FileFormatDescriptorXML.java

@@ -0,0 +1,93 @@
+/*
+ * Copyright (C) 2024 Philip Helger (www.helger.com)
+ * philip[at]helger[dot]com
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *         http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.helger.phive.binary.impl;
+
+import java.util.Map;
+
+import javax.annotation.Nonnull;
+
+import com.helger.commons.charset.EUnicodeBOM;
+import com.helger.commons.collection.ArrayHelper;
+import com.helger.commons.collection.impl.CommonsArrayList;
+import com.helger.commons.collection.impl.CommonsHashMap;
+import com.helger.commons.collection.impl.ICommonsList;
+import com.helger.commons.mime.CMimeType;
+import com.helger.phive.binary.AbstractFileFormatDescriptor;
+import com.helger.phive.binary.EPhiveContentValidationMode;
+import com.helger.phive.binary.IPhiveContentValidator;
+
+/**
+ * File format descriptor for XML documents
+ *
+ * @author Philip Helger
+ */
+public class FileFormatDescriptorXML extends AbstractFileFormatDescriptor
+{
+  private static final ICommonsList <byte []> PREFIXES = new CommonsArrayList <> (8 * EUnicodeBOM.values ().length);
+  static
+  {
+    // Add all XML mime types: as the combination of all BOMs and all character
+    // encodings as determined by
+    // http://www.w3.org/TR/REC-xml/#sec-guessing
+    final ICommonsList <byte []> aXMLStuff = new CommonsArrayList <> ();
+    // UCS4
+    aXMLStuff.add (new byte [] { 0x3c, 0x00, 0x00, 0x00, 0x3f, 0x00, 0x00, 0x00 });
+    aXMLStuff.add (new byte [] { 0x00, 0x3c, 0x00, 0x00, 0x00, 0x3f, 0x00, 0x00 });
+    aXMLStuff.add (new byte [] { 0x00, 0x00, 0x3c, 0x00, 0x00, 0x00, 0x3f, 0x00 });
+    aXMLStuff.add (new byte [] { 0x00, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x00, 0x3f });
+    // UTF-16
+    aXMLStuff.add (new byte [] { 0x00, 0x3c, 0x00, 0x3f });
+    aXMLStuff.add (new byte [] { 0x3c, 0x00, 0x3f, 0x00 });
+    // ISO-8859-1/UTF-8/ASCII etc.
+    aXMLStuff.add (new byte [] { 0x3c, 0x3f, 0x78, 0x6d });
+    // EBCDIC
+    aXMLStuff.add (new byte [] { 0x4c, 0x6f, (byte) 0xa7, (byte) 0x94 });
+
+    // Remember all types without the BOM
+    PREFIXES.addAll (aXMLStuff);
+
+    // Remember all types with each BOM
+    for (final EUnicodeBOM eBOM : EUnicodeBOM.values ())
+      for (final byte [] aXML : aXMLStuff)
+      {
+        final byte [] aData = ArrayHelper.getConcatenated (eBOM.getAllBytes (), aXML);
+        PREFIXES.add (aData);
+      }
+  }
+
+  @Nonnull
+  private static Map <EPhiveContentValidationMode, IPhiveContentValidator> _getContentValidators ()
+  {
+    final Map <EPhiveContentValidationMode, IPhiveContentValidator> ret = new CommonsHashMap <> ();
+    ret.put (EPhiveContentValidationMode.LEADING_BYTES, data -> {
+      for (final byte [] aPrefix : PREFIXES)
+        if (ArrayHelper.startsWith (data, aPrefix))
+          return true;
+      return false;
+    });
+    return ret;
+  }
+
+  public FileFormatDescriptorXML ()
+  {
+    super ("XML",
+           "XML",
+           new CommonsArrayList <> ("xml"),
+           new CommonsArrayList <> (CMimeType.APPLICATION_XML.getAsString (), CMimeType.TEXT_XML.getAsString ()),
+           _getContentValidators ());
+  }
+}

src/main/java/com/helger/phive/binary/impl/FileFormatRegistrarDefaultSPI.java

@@ -34,11 +34,13 @@ public void registerFileFormats (@Nonnull final IFileFormatRegistry aRegistry)
   {
     aRegistry.registerFileFormat (new FileFormatDescriptorCSV ());
     aRegistry.registerFileFormat (new FileFormatDescriptorGIF ());
+    aRegistry.registerFileFormat (new FileFormatDescriptorJPG ());
     aRegistry.registerFileFormat (new FileFormatDescriptorPDF ());
     aRegistry.registerFileFormat (new FileFormatDescriptorPNG ());
     aRegistry.registerFileFormat (new FileFormatDescriptorPSD ());
     aRegistry.registerFileFormat (new FileFormatDescriptorTIFF ());
     aRegistry.registerFileFormat (new FileFormatDescriptorXLS ());
     aRegistry.registerFileFormat (new FileFormatDescriptorXLSX ());
+    aRegistry.registerFileFormat (new FileFormatDescriptorXML ());
   }
 }