org.apache.batik.transcoder.TranscodingHints Maven / Gradle / Ivy
/*
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.batik.transcoder;
import java.util.HashMap;
import java.util.Map;
/**
* The TranscodingHints class defines a way to pass
* transcoding parameters or options to any transcoders.
*
* @author Thierry Kormann
* @version $Id$
*/
public class TranscodingHints extends HashMap {
/**
* Constructs a new empty TranscodingHints.
*/
public TranscodingHints() {
this(null);
}
/**
* Constructs a new TranscodingHints with keys and values
* initialized from the specified Map object (which may be null).
*
* @param init a map of key/value pairs to initialize the hints
* or null if the object should be empty
*/
public TranscodingHints(Map init) {
super(7);
if (init != null) {
putAll(init);
}
}
/**
* Returns true if this TranscodingHints contains a
* mapping for the specified key, false otherwise.
*
* @param key key whose present in this TranscodingHints
* is to be tested.
* @exception ClassCastException key is not of type
* TranscodingHints.Key
*/
public boolean containsKey(Object key) {
return super.containsKey(key);
}
/**
* Returns the value to which the specified key is mapped.
*
* @param key a trancoding hint key
* @exception ClassCastException key is not of type
* TranscodingHints.Key
*/
public Object get(Object key) {
return super.get(key);
}
/**
* Maps the specified key to the specified value
* in this TranscodingHints object.
*
* @param key the trancoding hint key.
* @param value the trancoding hint value.
* @exception IllegalArgumentException value is not
* appropriate for the specified key.
* @exception ClassCastException key is not of type
* TranscodingHints.Key
*/
public Object put(Object key, Object value) {
if (!((Key) key).isCompatibleValue(value)) {
throw new IllegalArgumentException(value+
" incompatible with "+
key);
}
return super.put(key, value);
}
/**
* Removes the key and its corresponding value from this
* TranscodingHints object.
*
* @param key the trancoding hints key that needs to be removed
* @exception ClassCastException key is not of type
* TranscodingHints.Key
*/
public Object remove(Object key) {
return super.remove(key);
}
/**
* Copies all of the keys and corresponding values from the
* specified TranscodingHints object to this
* TranscodingHints object.
*/
public void putAll(TranscodingHints hints) {
super.putAll(hints);
}
/**
* Copies all of the mappings from the specified Map
* to this TranscodingHints.
*
* @param m mappings to be stored in this TranscodingHints.
* @exception ClassCastException key is not of type
* TranscodingHints.Key
*/
public void putAll(Map m) {
if (m instanceof TranscodingHints) {
putAll(((TranscodingHints) m));
} else {
for (Object o : m.entrySet()) {
Map.Entry entry = (Map.Entry) o;
put(entry.getKey(), entry.getValue());
}
}
}
/**
* Defines the base type of all keys used to control various
* aspects of the transcoding operations.
*/
public abstract static class Key {
/**
* Constructs a key.
*/
protected Key() { }
/**
* Returns true if the specified object is a valid value for
* this key, false otherwise.
*/
public abstract boolean isCompatibleValue(Object val);
}
}