blob: c133b7a111d3034425bbabe16011c2dae7c1c01a [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.5.0_12) on Fri May 30 11:15:50 CDT 2008 -->
<TITLE>
WorkingCopyOwner
</TITLE>
<META NAME="keywords" CONTENT="org.eclipse.wst.jsdt.core.WorkingCopyOwner class">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
parent.document.title="WorkingCopyOwner";
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/WorkingCopyOwner.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../../org/eclipse/wst/jsdt/core/UnimplementedException.html" title="class in org.eclipse.wst.jsdt.core"><B>PREV CLASS</B></A>&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../../index.html?org/eclipse/wst/jsdt/core/WorkingCopyOwner.html" target="_top"><B>FRAMES</B></A> &nbsp;
&nbsp;<A HREF="WorkingCopyOwner.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
&nbsp;<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
org.eclipse.wst.jsdt.core</FONT>
<BR>
Class WorkingCopyOwner</H2>
<PRE>
java.lang.Object
<IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>org.eclipse.wst.jsdt.core.WorkingCopyOwner</B>
</PRE>
<HR>
<DL>
<DT><PRE>public abstract class <B>WorkingCopyOwner</B><DT>extends java.lang.Object</DL>
</PRE>
<P>
The owner of an <A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core"><CODE>IJavaScriptUnit</CODE></A> handle in working copy mode.
An owner is used to identify a working copy and to create its buffer.
<p>
Clients should subclass this class to instantiate a working copy owner that is specific to their need and that
they can pass in to various APIs (e.g. <A HREF="../../../../../org/eclipse/wst/jsdt/core/IType.html#resolveType(java.lang.String, org.eclipse.wst.jsdt.core.WorkingCopyOwner)"><CODE>IType.resolveType(String, WorkingCopyOwner)</CODE></A>.
Clients can also override the default implementation of <A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#createBuffer(org.eclipse.wst.jsdt.core.IJavaScriptUnit)"><CODE>createBuffer(IJavaScriptUnit)</CODE></A>.
</p><p>
Note: even though this class has no abstract method, which means that it provides functional default behavior,
it is still an abstract class, as clients are intended to own their owner implementation.
</p>
<P>
<P>
<DL>
<DT><B>See Also:</B><DD><CODE>IJavaScriptUnit#becomeWorkingCopy(org.eclipse.core.runtime.IProgressMonitor)</CODE>,
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html#discardWorkingCopy()"><CODE>IJavaScriptUnit.discardWorkingCopy()</CODE></A>,
<CODE>Provisional API: This class/interface is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.</CODE></DL>
<HR>
<P>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#WorkingCopyOwner()">WorkingCopyOwner</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
</TABLE>
&nbsp;
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../../org/eclipse/wst/jsdt/core/IBuffer.html" title="interface in org.eclipse.wst.jsdt.core">IBuffer</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#createBuffer(org.eclipse.wst.jsdt.core.IJavaScriptUnit)">createBuffer</A></B>(<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core">IJavaScriptUnit</A>&nbsp;workingCopy)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a buffer for the given working copy.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../../org/eclipse/wst/jsdt/core/IProblemRequestor.html" title="interface in org.eclipse.wst.jsdt.core">IProblemRequestor</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#getProblemRequestor(org.eclipse.wst.jsdt.core.IJavaScriptUnit)">getProblemRequestor</A></B>(<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core">IJavaScriptUnit</A>&nbsp;workingCopy)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the problem requestor used by a working copy of this working copy owner.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core">IJavaScriptUnit</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#newWorkingCopy(java.lang.String, org.eclipse.wst.jsdt.core.IIncludePathEntry[], org.eclipse.wst.jsdt.core.IProblemRequestor, IProgressMonitor)">newWorkingCopy</A></B>(java.lang.String&nbsp;name,
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IIncludePathEntry.html" title="interface in org.eclipse.wst.jsdt.core">IIncludePathEntry</A>[]&nbsp;classpath,
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IProblemRequestor.html" title="interface in org.eclipse.wst.jsdt.core">IProblemRequestor</A>&nbsp;problemRequestor,
IProgressMonitor&nbsp;monitor)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Use <A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#newWorkingCopy(java.lang.String, org.eclipse.wst.jsdt.core.IIncludePathEntry[], IProgressMonitor)"><CODE>newWorkingCopy(String, IIncludePathEntry[], IProgressMonitor)</CODE></A> instead.
Note that if this deprecated method is used, problems may be reported twice
if the given requestor is not the same as the current working copy owner one.</I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core">IJavaScriptUnit</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#newWorkingCopy(java.lang.String, org.eclipse.wst.jsdt.core.IIncludePathEntry[], IProgressMonitor)">newWorkingCopy</A></B>(java.lang.String&nbsp;name,
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IIncludePathEntry.html" title="interface in org.eclipse.wst.jsdt.core">IIncludePathEntry</A>[]&nbsp;classpath,
IProgressMonitor&nbsp;monitor)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a new working copy with the given name using this working copy owner to
create its buffer.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#setPrimaryBufferProvider(org.eclipse.wst.jsdt.core.WorkingCopyOwner)">setPrimaryBufferProvider</A></B>(<A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html" title="class in org.eclipse.wst.jsdt.core">WorkingCopyOwner</A>&nbsp;primaryBufferProvider)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the buffer provider of the primary working copy owner.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="WorkingCopyOwner()"><!-- --></A><H3>
WorkingCopyOwner</H3>
<PRE>
public <B>WorkingCopyOwner</B>()</PRE>
<DL>
</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="setPrimaryBufferProvider(org.eclipse.wst.jsdt.core.WorkingCopyOwner)"><!-- --></A><H3>
setPrimaryBufferProvider</H3>
<PRE>
public static void <B>setPrimaryBufferProvider</B>(<A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html" title="class in org.eclipse.wst.jsdt.core">WorkingCopyOwner</A>&nbsp;primaryBufferProvider)</PRE>
<DL>
<DD>Sets the buffer provider of the primary working copy owner. Note that even if the
buffer provider is a working copy owner, only its <code>createBuffer(IJavaScriptUnit)</code>
method is used by the primary working copy owner. It doesn't replace the internal primary
working owner.
<p>
This method is for internal use by the jsdt-related plug-ins.
Clients outside of the jsdt should not reference this method.
</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>primaryBufferProvider</CODE> - the primary buffer provider</DL>
</DD>
</DL>
<HR>
<A NAME="createBuffer(org.eclipse.wst.jsdt.core.IJavaScriptUnit)"><!-- --></A><H3>
createBuffer</H3>
<PRE>
public <A HREF="../../../../../org/eclipse/wst/jsdt/core/IBuffer.html" title="interface in org.eclipse.wst.jsdt.core">IBuffer</A> <B>createBuffer</B>(<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core">IJavaScriptUnit</A>&nbsp;workingCopy)</PRE>
<DL>
<DD>Creates a buffer for the given working copy.
The new buffer will be initialized with the contents of the underlying file
if and only if it was not already initialized by the compilation owner (a buffer is
uninitialized if its content is <code>null</code>).
<p>
Note: This buffer will be associated to the working copy for its entire life-cycle. Another
working copy on same unit but owned by a different owner would not share the same buffer
unless its owner decided to implement such a sharing behaviour.
</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>workingCopy</CODE> - the working copy of the buffer
<DT><B>Returns:</B><DD>IBuffer the created buffer for the given working copy<DT><B>See Also:</B><DD><A HREF="../../../../../org/eclipse/wst/jsdt/core/IBuffer.html" title="interface in org.eclipse.wst.jsdt.core"><CODE>IBuffer</CODE></A></DL>
</DD>
</DL>
<HR>
<A NAME="getProblemRequestor(org.eclipse.wst.jsdt.core.IJavaScriptUnit)"><!-- --></A><H3>
getProblemRequestor</H3>
<PRE>
public <A HREF="../../../../../org/eclipse/wst/jsdt/core/IProblemRequestor.html" title="interface in org.eclipse.wst.jsdt.core">IProblemRequestor</A> <B>getProblemRequestor</B>(<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core">IJavaScriptUnit</A>&nbsp;workingCopy)</PRE>
<DL>
<DD>Returns the problem requestor used by a working copy of this working copy owner.
<p>
By default, no problem requestor is configured. Clients can override this
method to provide a requestor.
</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>workingCopy</CODE> - The problem requestor used for the given working copy.
<DT><B>Returns:</B><DD>the problem requestor to be used by working copies of this working
copy owner or <code>null</code> if no problem requestor is configured.</DL>
</DD>
</DL>
<HR>
<A NAME="newWorkingCopy(java.lang.String, org.eclipse.wst.jsdt.core.IIncludePathEntry[], org.eclipse.wst.jsdt.core.IProblemRequestor, IProgressMonitor)"><!-- --></A><H3>
newWorkingCopy</H3>
<PRE>
public final <A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core">IJavaScriptUnit</A> <B>newWorkingCopy</B>(java.lang.String&nbsp;name,
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IIncludePathEntry.html" title="interface in org.eclipse.wst.jsdt.core">IIncludePathEntry</A>[]&nbsp;classpath,
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IProblemRequestor.html" title="interface in org.eclipse.wst.jsdt.core">IProblemRequestor</A>&nbsp;problemRequestor,
IProgressMonitor&nbsp;monitor)
throws <A HREF="../../../../../org/eclipse/wst/jsdt/core/JavaScriptModelException.html" title="class in org.eclipse.wst.jsdt.core">JavaScriptModelException</A></PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>Use <A HREF="../../../../../org/eclipse/wst/jsdt/core/WorkingCopyOwner.html#newWorkingCopy(java.lang.String, org.eclipse.wst.jsdt.core.IIncludePathEntry[], IProgressMonitor)"><CODE>newWorkingCopy(String, IIncludePathEntry[], IProgressMonitor)</CODE></A> instead.
Note that if this deprecated method is used, problems may be reported twice
if the given requestor is not the same as the current working copy owner one.</I>
<P>
<DD>Returns a new working copy with the given name using this working copy owner to
create its buffer.
<p>
This working copy always belongs to the default package in a package
fragment root that corresponds to its JavaScript project, and this JavaScript project never exists.
However this JavaScript project has the given includepath that is used when resolving names
in this working copy.
</p><p>
A DOM AST created using this working copy will have bindings resolved using the given
includepath, and problem are reported to the given problem requestor.
<p></p>
<code>JavaScriptCore#getOptions()</code> is used to create the DOM AST as it is not
possible to set the options on the non-existing JavaScript project.
</p><p>
When the working copy instance is created, an <A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptElementDelta.html#ADDED"><CODE>added delta</CODE></A> is
reported on this working copy.
</p><p>
Once done with the working copy, users of this method must discard it using
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html#discardWorkingCopy()"><CODE>IJavaScriptUnit.discardWorkingCopy()</CODE></A>.
</p><p>
Note that when such working copy is committed, only its buffer is saved (see
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IBuffer.html#save(IProgressMonitor, boolean)"><CODE>IBuffer.save(IProgressMonitor, boolean)</CODE></A>) but no resource is created.
</p><p>
This method is not intended to be overriden by clients.
</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the working copy (e.g. "X.js")<DD><CODE>includepath</CODE> - the includepath used to resolve names in this working copy<DD><CODE>problemRequestor</CODE> - a requestor which will get notified of problems detected during
reconciling as they are discovered. The requestor can be set to <code>null</code> indicating
that the client is not interested in problems.<DD><CODE>monitor</CODE> - a progress monitor used to report progress while opening the working copy
or <code>null</code> if no progress should be reported
<DT><B>Returns:</B><DD>a new working copy
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../org/eclipse/wst/jsdt/core/JavaScriptModelException.html" title="class in org.eclipse.wst.jsdt.core">JavaScriptModelException</A></CODE> - if the contents of this working copy can
not be determined.<DT><B>See Also:</B><DD><A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html#becomeWorkingCopy(org.eclipse.wst.jsdt.core.IProblemRequestor, IProgressMonitor)"><CODE>IJavaScriptUnit.becomeWorkingCopy(IProblemRequestor, IProgressMonitor)</CODE></A></DL>
</DD>
</DL>
<HR>
<A NAME="newWorkingCopy(java.lang.String, org.eclipse.wst.jsdt.core.IIncludePathEntry[], IProgressMonitor)"><!-- --></A><H3>
newWorkingCopy</H3>
<PRE>
public final <A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html" title="interface in org.eclipse.wst.jsdt.core">IJavaScriptUnit</A> <B>newWorkingCopy</B>(java.lang.String&nbsp;name,
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IIncludePathEntry.html" title="interface in org.eclipse.wst.jsdt.core">IIncludePathEntry</A>[]&nbsp;classpath,
IProgressMonitor&nbsp;monitor)
throws <A HREF="../../../../../org/eclipse/wst/jsdt/core/JavaScriptModelException.html" title="class in org.eclipse.wst.jsdt.core">JavaScriptModelException</A></PRE>
<DL>
<DD>Returns a new working copy with the given name using this working copy owner to
create its buffer.
<p>
This working copy always belongs to the default package in a package
fragment root that corresponds to its JavaScript project, and this JavaScript project never exists.
However this JavaScript project has the given includepath that is used when resolving names
in this working copy.
</p><p>
If a DOM AST is created using this working copy, then given includepath will be used
if bindings need to be resolved. Problems will be reported to the problem requestor
of the current working copy owner problem if it is not <code>null</code>.
<p></p>
Options used to create the DOM AST are got from <A HREF="../../../../../org/eclipse/wst/jsdt/core/JavaScriptCore.html#getOptions()"><CODE>JavaScriptCore.getOptions()</CODE></A>
as it is not possible to set the options on a non-existing JavaScript project.
</p><p>
When the working copy instance is created, an <A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptElementDelta.html#ADDED"><CODE>added delta</CODE></A> is
reported on this working copy.
</p><p>
Once done with the working copy, users of this method must discard it using
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html#discardWorkingCopy()"><CODE>IJavaScriptUnit.discardWorkingCopy()</CODE></A>.
</p><p>
Note that when such working copy is committed, only its buffer is saved (see
<A HREF="../../../../../org/eclipse/wst/jsdt/core/IBuffer.html#save(IProgressMonitor, boolean)"><CODE>IBuffer.save(IProgressMonitor, boolean)</CODE></A>) but no resource is created.
</p><p>
This method is not intended to be overriden by clients.
</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the working copy (e.g. "X.js")<DD><CODE>classpath</CODE> - the includepath used to resolve names in this working copy<DD><CODE>monitor</CODE> - a progress monitor used to report progress while opening the working copy
or <code>null</code> if no progress should be reported
<DT><B>Returns:</B><DD>a new working copy
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../org/eclipse/wst/jsdt/core/JavaScriptModelException.html" title="class in org.eclipse.wst.jsdt.core">JavaScriptModelException</A></CODE> - if the contents of this working copy can
not be determined.<DT><B>See Also:</B><DD><A HREF="../../../../../org/eclipse/wst/jsdt/core/IJavaScriptUnit.html#becomeWorkingCopy(IProgressMonitor)"><CODE>IJavaScriptUnit.becomeWorkingCopy(IProgressMonitor)</CODE></A></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/WorkingCopyOwner.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../../org/eclipse/wst/jsdt/core/UnimplementedException.html" title="class in org.eclipse.wst.jsdt.core"><B>PREV CLASS</B></A>&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../../index.html?org/eclipse/wst/jsdt/core/WorkingCopyOwner.html" target="_top"><B>FRAMES</B></A> &nbsp;
&nbsp;<A HREF="WorkingCopyOwner.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
&nbsp;<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
</BODY>
</HTML>