01: /* ====================================================================
02: Licensed to the Apache Software Foundation (ASF) under one or more
03: contributor license agreements. See the NOTICE file distributed with
04: this work for additional information regarding copyright ownership.
05: The ASF licenses this file to You under the Apache License, Version 2.0
06: (the "License"); you may not use this file except in compliance with
07: the License. You may obtain a copy of the License at
08:
09: http://www.apache.org/licenses/LICENSE-2.0
10:
11: Unless required by applicable law or agreed to in writing, software
12: distributed under the License is distributed on an "AS IS" BASIS,
13: WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: See the License for the specific language governing permissions and
15: limitations under the License.
16: ==================================================================== */
17:
18: package org.apache.poi.hpsf;
19:
20: import org.apache.poi.util.HexDump;
21:
22: /**
23: * <p>This exception is thrown if HPSF encounters a variant type that isn't
24: * supported yet. Although a variant type is unsupported the value can still be
25: * retrieved using the {@link VariantTypeException#getValue} method.</p>
26: *
27: * <p>Obviously this class should disappear some day.</p>
28: *
29: * @author Rainer Klute <a
30: * href="mailto:klute@rainer-klute.de"><klute@rainer-klute.de></a>
31: * @since 2003-08-05
32: * @version $Id: UnsupportedVariantTypeException.java 489730 2006-12-22 19:18:16Z bayard $
33: */
34: public abstract class UnsupportedVariantTypeException extends
35: VariantTypeException {
36:
37: /**
38: * <p>Constructor.</p>
39: *
40: * @param variantType The unsupported variant type
41: * @param value The value who's variant type is not yet supported
42: */
43: public UnsupportedVariantTypeException(final long variantType,
44: final Object value) {
45: super (
46: variantType,
47: value,
48: "HPSF does not yet support the variant type "
49: + variantType
50: + " ("
51: + Variant.getVariantName(variantType)
52: + ", "
53: + HexDump.toHex(variantType)
54: + "). If you want support for "
55: + "this variant type in one of the next POI releases please "
56: + "submit a request for enhancement (RFE) to "
57: + "<http://issues.apache.org/bugzilla/>! Thank you!");
58: }
59:
60: }
|