KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > tomcat > jni > Error


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  * @version $Revision: 467222 $, $Date: 2006-10-24 05:17:11 +0200 (mar., 24 oct. 2006) $
24  */

25
26 public class Error extends Exception JavaDoc {
27
28     /**
29      * APR error type.
30      */

31     private int error;
32
33     /**
34      * A description of the problem.
35      */

36     private String JavaDoc 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 JavaDoc description)
45     {
46         super(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 JavaDoc 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, on 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 JavaDoc strerror(int statcode);
95
96 }
97
Popular Tags