Home | History | Annotate | Download | only in src 
      1 // Copyright 2008 the V8 project authors. All rights reserved.
      2 // Redistribution and use in source and binary forms, with or without
      3 // modification, are permitted provided that the following conditions are
      4 // met:
      5 //
      6 //     * Redistributions of source code must retain the above copyright
      7 //       notice, this list of conditions and the following disclaimer.
      8 //     * Redistributions in binary form must reproduce the above
      9 //       copyright notice, this list of conditions and the following
     10 //       disclaimer in the documentation and/or other materials provided
     11 //       with the distribution.
     12 //     * Neither the name of Google Inc. nor the names of its
     13 //       contributors may be used to endorse or promote products derived
     14 //       from this software without specific prior written permission.
     15 //
     16 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     17 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     18 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     19 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     20 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     21 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
     22 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     23 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     24 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     25 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     26 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     27 
     28 #ifndef V8_COMPILATION_CACHE_H_
     29 #define V8_COMPILATION_CACHE_H_
     30 
     31 namespace v8 {
     32 namespace internal {
     33 
     34 
     35 // The compilation cache keeps function boilerplates for compiled
     36 // scripts and evals. The boilerplates are looked up using the source
     37 // string as the key. For regular expressions the compilation data is cached.
     38 class CompilationCache {
     39  public:
     40   // Finds the script function boilerplate for a source
     41   // string. Returns an empty handle if the cache doesn't contain a
     42   // script for the given source string with the right origin.
     43   static Handle<JSFunction> LookupScript(Handle<String> source,
     44                                          Handle<Object> name,
     45                                          int line_offset,
     46                                          int column_offset);
     47 
     48   // Finds the function boilerplate for a source string for eval in a
     49   // given context.  Returns an empty handle if the cache doesn't
     50   // contain a script for the given source string.
     51   static Handle<JSFunction> LookupEval(Handle<String> source,
     52                                        Handle<Context> context,
     53                                        bool is_global);
     54 
     55   // Returns the regexp data associated with the given regexp if it
     56   // is in cache, otherwise an empty handle.
     57   static Handle<FixedArray> LookupRegExp(Handle<String> source,
     58                                          JSRegExp::Flags flags);
     59 
     60   // Associate the (source, kind) pair to the boilerplate. This may
     61   // overwrite an existing mapping.
     62   static void PutScript(Handle<String> source,
     63                         Handle<JSFunction> boilerplate);
     64 
     65   // Associate the (source, context->closure()->shared(), kind) triple
     66   // with the boilerplate. This may overwrite an existing mapping.
     67   static void PutEval(Handle<String> source,
     68                       Handle<Context> context,
     69                       bool is_global,
     70                       Handle<JSFunction> boilerplate);
     71 
     72   // Associate the (source, flags) pair to the given regexp data.
     73   // This may overwrite an existing mapping.
     74   static void PutRegExp(Handle<String> source,
     75                         JSRegExp::Flags flags,
     76                         Handle<FixedArray> data);
     77 
     78   // Clear the cache - also used to initialize the cache at startup.
     79   static void Clear();
     80 
     81   // GC support.
     82   static void Iterate(ObjectVisitor* v);
     83 
     84   // Notify the cache that a mark-sweep garbage collection is about to
     85   // take place. This is used to retire entries from the cache to
     86   // avoid keeping them alive too long without using them.
     87   static void MarkCompactPrologue();
     88 
     89   // Enable/disable compilation cache. Used by debugger to disable compilation
     90   // cache during debugging to make sure new scripts are always compiled.
     91   static void Enable();
     92   static void Disable();
     93 };
     94 
     95 
     96 } }  // namespace v8::internal
     97 
     98 #endif  // V8_COMPILATION_CACHE_H_
     99