FormatFlagsConversionMismatchException.java revision dd828f42a5c83b4270d4fbf6fce2da1878f1e84a
1/* Licensed to the Apache Software Foundation (ASF) under one or more
2 * contributor license agreements.  See the NOTICE file distributed with
3 * this work for additional information regarding copyright ownership.
4 * The ASF licenses this file to You under the Apache License, Version 2.0
5 * (the "License"); you may not use this file except in compliance with
6 * the License.  You may obtain a copy of the License at
7 *
8 *     http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package java.util;
18
19import java.io.Serializable;
20
21/**
22 * A {@code FormatFlagsConversionMismatchException} will be thrown if a
23 * conversion and the flags are incompatible.
24 *
25 * @see java.lang.RuntimeException
26 * @since Android 1.0
27 */
28public class FormatFlagsConversionMismatchException extends
29        IllegalFormatException implements Serializable {
30
31    private static final long serialVersionUID = 19120414L;
32
33    private String f;
34
35    private char c;
36
37    /**
38     * Constructs a new {@code FormatFlagsConversionMismatchException} with the
39     * flags and conversion specified.
40     *
41     * @param f
42     *           the flags.
43     * @param c
44     *           the conversion.
45     */
46    public FormatFlagsConversionMismatchException(String f, char c) {
47        if (null == f) {
48            throw new NullPointerException();
49        }
50        this.f = f;
51        this.c = c;
52    }
53
54    /**
55     * Returns the incompatible format flag.
56     *
57     * @return the incompatible format flag.
58     */
59    public String getFlags() {
60        return f;
61    }
62
63    /**
64     * Returns the incompatible conversion.
65     *
66     * @return the incompatible conversion.
67     */
68    public char getConversion() {
69        return c;
70    }
71
72    /**
73     * Returns the message string of the {@code FormatFlagsConversionMismatchException}.
74     *
75     * @return the message string of the {@code FormatFlagsConversionMismatchException}.
76     */
77    @Override
78    public String getMessage() {
79        StringBuilder buffer = new StringBuilder();
80        buffer.append("Mismatched Convertor =");
81        buffer.append(c);
82        buffer.append(", Flags= ");
83        buffer.append(f);
84        return buffer.toString();
85    }
86}
87