/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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 org.apache.commons.compress.archivers.sevenz;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
Base Codec class.
/**
* Base Codec class.
*/
abstract class CoderBase {
private final Class<?>[] acceptableOptions;
private static final byte[] NONE = new byte[0];
Params: - acceptableOptions – types that can be used as options for this codec.
/**
* @param acceptableOptions types that can be used as options for this codec.
*/
protected CoderBase(final Class<?>... acceptableOptions) {
this.acceptableOptions = acceptableOptions;
}
Returns: whether this method can extract options from the given object.
/**
* @return whether this method can extract options from the given object.
*/
boolean canAcceptOptions(final Object opts) {
for (final Class<?> c : acceptableOptions) {
if (c.isInstance(opts)) {
return true;
}
}
return false;
}
Returns: property-bytes to write in a Folder block
/**
* @return property-bytes to write in a Folder block
*/
byte[] getOptionsAsProperties(final Object options) throws IOException {
return NONE;
}
Returns: configuration options that have been used to create the given InputStream from the given Coder
/**
* @return configuration options that have been used to create the given InputStream from the given Coder
*/
Object getOptionsFromCoder(final Coder coder, final InputStream in) throws IOException {
return null;
}
Returns: a stream that reads from in using the configured coder and password.
/**
* @return a stream that reads from in using the configured coder and password.
*/
abstract InputStream decode(final String archiveName,
final InputStream in, long uncomressedLength,
final Coder coder, byte[] password) throws IOException;
Returns: a stream that writes to out using the given configuration.
/**
* @return a stream that writes to out using the given configuration.
*/
OutputStream encode(final OutputStream out, final Object options) throws IOException {
throw new UnsupportedOperationException("method doesn't support writing");
}
If the option represents a number, return its integer
value, otherwise return the given default value.
/**
* If the option represents a number, return its integer
* value, otherwise return the given default value.
*/
protected static int numberOptionOrDefault(final Object options, final int defaultValue) {
return options instanceof Number ? ((Number) options).intValue() : defaultValue;
}
}