OLD | NEW |
| (Empty) |
1 /* | |
2 * Licensed to the Apache Software Foundation (ASF) under one or more | |
3 * contributor license agreements. See the NOTICE file distributed with | |
4 * this work for additional information regarding copyright ownership. | |
5 * The ASF licenses this file to You under the Apache License, Version 2.0 | |
6 * (the "License"); you may not use this file except in compliance with | |
7 * the License. You may obtain a copy of the License at | |
8 * | |
9 * 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.tomcat.jni; | |
19 | |
20 /** Error | |
21 * | |
22 * @author Mladen Turk | |
23 */ | |
24 public class Error extends Exception { | |
25 | |
26 private static final long serialVersionUID = 1L; | |
27 | |
28 /** | |
29 * APR error type. | |
30 */ | |
31 private final int error; | |
32 | |
33 /** | |
34 * A description of the problem. | |
35 */ | |
36 private final String description; | |
37 | |
38 /** | |
39 * Construct an APRException. | |
40 * | |
41 * @param error one of the value in Error | |
42 * @param description error message | |
43 */ | |
44 private Error(int error, String description) | |
45 { | |
46 super(error + ": " + description); | |
47 this.error = error; | |
48 this.description = description; | |
49 } | |
50 | |
51 /** | |
52 * Get the APR error code of the exception. | |
53 * | |
54 * @return error of the Exception | |
55 */ | |
56 public int getError() | |
57 { | |
58 return error; | |
59 } | |
60 | |
61 /** | |
62 * Get the APR description of the exception. | |
63 * | |
64 * @return description of the Exception | |
65 */ | |
66 public String getDescription() | |
67 { | |
68 return description; | |
69 } | |
70 | |
71 /** | |
72 * Get the last platform error. | |
73 * @return apr_status_t the last platform error, folded into apr_status_t, o
n most platforms | |
74 * This retrieves errno, or calls a GetLastError() style function, and | |
75 * folds it with APR_FROM_OS_ERROR. Some platforms (such as OS2) have
no | |
76 * such mechanism, so this call may be unsupported. Do NOT use this | |
77 * call for socket errors from socket, send, recv etc! | |
78 */ | |
79 public static native int osError(); | |
80 | |
81 /** | |
82 * Get the last platform socket error. | |
83 * @return the last socket error, folded into apr_status_t, on all platforms | |
84 * This retrieves errno or calls a GetLastSocketError() style function, | |
85 * and folds it with APR_FROM_OS_ERROR. | |
86 */ | |
87 public static native int netosError(); | |
88 | |
89 /** | |
90 * Return a human readable string describing the specified error. | |
91 * @param statcode The error code the get a string for. | |
92 * @return The error string. | |
93 */ | |
94 public static native String strerror(int statcode); | |
95 | |
96 } | |
OLD | NEW |