src/messages.h
説明を見る。
00001 // Copyright 2006-2008 the V8 project authors. All rights reserved. 00002 // Redistribution and use in source and binary forms, with or without 00003 // modification, are permitted provided that the following conditions are 00004 // met: 00005 // 00006 // * Redistributions of source code must retain the above copyright 00007 // notice, this list of conditions and the following disclaimer. 00008 // * Redistributions in binary form must reproduce the above 00009 // copyright notice, this list of conditions and the following 00010 // disclaimer in the documentation and/or other materials provided 00011 // with the distribution. 00012 // * Neither the name of Google Inc. nor the names of its 00013 // contributors may be used to endorse or promote products derived 00014 // from this software without specific prior written permission. 00015 // 00016 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 00017 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 00018 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 00019 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 00020 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00021 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00022 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 00023 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 00024 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 00025 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 00026 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00027 00028 // The infrastructure used for (localized) message reporting in V8. 00029 // 00030 // Note: there's a big unresolved issue about ownership of the data 00031 // structures used by this framework. 00032 00033 #ifndef V8_MESSAGES_H_ 00034 #define V8_MESSAGES_H_ 00035 00036 #include "handles-inl.h" 00037 00038 // Forward declaration of MessageLocation. 00039 namespace v8 { namespace internal { 00040 class MessageLocation; 00041 } } // namespace v8::internal 00042 00043 00044 class V8Message { 00045 public: 00046 V8Message(char* type, 00047 v8::internal::Handle<v8::internal::JSArray> args, 00048 const v8::internal::MessageLocation* loc) : 00049 type_(type), args_(args), loc_(loc) { } 00050 char* type() const { return type_; } 00051 v8::internal::Handle<v8::internal::JSArray> args() const { return args_; } 00052 const v8::internal::MessageLocation* loc() const { return loc_; } 00053 private: 00054 char* type_; 00055 v8::internal::Handle<v8::internal::JSArray> const args_; 00056 const v8::internal::MessageLocation* loc_; 00057 }; 00058 00059 00060 namespace v8 { namespace internal { 00061 00062 struct Language; 00063 class SourceInfo; 00064 00065 class MessageLocation { 00066 public: 00067 MessageLocation(Handle<Script> script, 00068 int start_pos, 00069 int end_pos) 00070 : script_(script), 00071 start_pos_(start_pos), 00072 end_pos_(end_pos) { } 00073 MessageLocation() : start_pos_(-1), end_pos_(-1) { } 00074 00075 Handle<Script> script() const { return script_; } 00076 int start_pos() const { return start_pos_; } 00077 int end_pos() const { return end_pos_; } 00078 00079 private: 00080 Handle<Script> script_; 00081 int start_pos_; 00082 int end_pos_; 00083 }; 00084 00085 00086 // A message handler is a convenience interface for accessing the list 00087 // of message listeners registered in an environment 00088 class MessageHandler { 00089 public: 00090 // Report a message (w/o JS heap allocation). 00091 static void ReportMessage(const char* msg); 00092 00093 // Returns a message object for the API to use. 00094 static Handle<Object> MakeMessageObject(const char* type, 00095 MessageLocation* loc, 00096 Vector< Handle<Object> > args, 00097 Handle<String> stack_trace); 00098 00099 // Report a formatted message (needs JS allocation). 00100 static void ReportMessage(MessageLocation* loc, Handle<Object> message); 00101 00102 static void DefaultMessageReport(const MessageLocation* loc, 00103 Handle<Object> message_obj); 00104 static Handle<String> GetMessage(Handle<Object> data); 00105 static SmartPointer<char> GetLocalizedMessage(Handle<Object> data); 00106 }; 00107 00108 } } // namespace v8::internal 00109 00110 #endif // V8_MESSAGES_H_
