summaryrefslogtreecommitdiff
path: root/udkapi/com/sun/star/uri
diff options
context:
space:
mode:
Diffstat (limited to 'udkapi/com/sun/star/uri')
-rw-r--r--udkapi/com/sun/star/uri/ExternalUriReferenceTranslator.idl45
-rw-r--r--udkapi/com/sun/star/uri/RelativeUriExcessParentSegments.idl62
-rw-r--r--udkapi/com/sun/star/uri/UriReferenceFactory.idl77
-rw-r--r--udkapi/com/sun/star/uri/UriSchemeParser_vndDOTsunDOTstarDOTexpand.idl58
-rw-r--r--udkapi/com/sun/star/uri/UriSchemeParser_vndDOTsunDOTstarDOTscript.idl58
-rw-r--r--udkapi/com/sun/star/uri/VndSunStarPkgUrlReferenceFactory.idl45
-rw-r--r--udkapi/com/sun/star/uri/XExternalUriReferenceTranslator.idl91
-rw-r--r--udkapi/com/sun/star/uri/XUriReference.idl231
-rw-r--r--udkapi/com/sun/star/uri/XUriReferenceFactory.idl163
-rw-r--r--udkapi/com/sun/star/uri/XUriSchemeParser.idl75
-rw-r--r--udkapi/com/sun/star/uri/XVndSunStarExpandUrl.idl77
-rw-r--r--udkapi/com/sun/star/uri/XVndSunStarExpandUrlReference.idl59
-rw-r--r--udkapi/com/sun/star/uri/XVndSunStarPkgUrlReferenceFactory.idl61
-rw-r--r--udkapi/com/sun/star/uri/XVndSunStarScriptUrl.idl137
-rw-r--r--udkapi/com/sun/star/uri/XVndSunStarScriptUrlReference.idl57
-rw-r--r--udkapi/com/sun/star/uri/makefile.mk54
16 files changed, 1350 insertions, 0 deletions
diff --git a/udkapi/com/sun/star/uri/ExternalUriReferenceTranslator.idl b/udkapi/com/sun/star/uri/ExternalUriReferenceTranslator.idl
new file mode 100644
index 000000000000..3ed909101441
--- /dev/null
+++ b/udkapi/com/sun/star/uri/ExternalUriReferenceTranslator.idl
@@ -0,0 +1,45 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_ExternalUriReferenceTranslator_idl__
+#define __com_sun_star_uri_ExternalUriReferenceTranslator_idl__
+
+module com { module sun { module star { module uri {
+
+published interface XExternalUriReferenceTranslator;
+
+/**
+ translates between external and internal URI references.
+
+ @since OOo 2.0.0
+ */
+published service ExternalUriReferenceTranslator:
+ XExternalUriReferenceTranslator;
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/RelativeUriExcessParentSegments.idl b/udkapi/com/sun/star/uri/RelativeUriExcessParentSegments.idl
new file mode 100644
index 000000000000..6d65648b7950
--- /dev/null
+++ b/udkapi/com/sun/star/uri/RelativeUriExcessParentSegments.idl
@@ -0,0 +1,62 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_RelativeUriExcessParentSegments_idl__
+#define __com_sun_star_uri_RelativeUriExcessParentSegments_idl__
+
+module com { module sun { module star { module uri {
+
+/**
+ details how excess special parent segments (&ldquo;<code>..</code>&rdquo;)
+ are handled when resolving a relative URI reference to absolute form.
+
+ @see com::sun::star::uri::XUriReferenceFactory::makeAbsolute
+ for a method that uses this enumeration.
+
+ @since OOo 2.0.0
+ */
+published enum RelativeUriExcessParentSegments {
+ /**
+ causes excess special parent segments to be treated as an error.
+ */
+ ERROR,
+
+ /**
+ causes excess special parent segments to be retained, treating them like
+ ordinary segments.
+ */
+ RETAIN,
+
+ /**
+ causes excess special parent segments to be removed.
+ */
+ REMOVE
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/UriReferenceFactory.idl b/udkapi/com/sun/star/uri/UriReferenceFactory.idl
new file mode 100644
index 000000000000..678258d75ce0
--- /dev/null
+++ b/udkapi/com/sun/star/uri/UriReferenceFactory.idl
@@ -0,0 +1,77 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_UriReferenceFactory_idl__
+#define __com_sun_star_uri_UriReferenceFactory_idl__
+
+module com { module sun { module star { module uri {
+
+published interface XUriReferenceFactory;
+
+/**
+ creates URI references.
+
+ <p>See <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC&nbsp;2396</a> for a
+ description of URI references and related terms.</p>
+
+ <p>For parsing absolute URI references, this service tries to use a
+ scheme-specific parser. Such a scheme-specific parser will typically enforce
+ additional restrictions during parsing, and will typically return objects
+ that support extra, scheme-specific interfaces in addition to
+ <type scope="com::sun::star::uri">XUriReference</type>. If no such parser
+ is found, and for relative URI references, a generic parser is used, which
+ returns objects that only support
+ <type scope="com::sun::star::uri">XUriReference</type>.</p>
+
+ <p>Locating a scheme-specific parser works as follows: A scheme consists of
+ Latin captial letters
+ &ldquo;<code>A</code>&rdquo;&ndash;&ldquo;<code>Z</code>&rdquo;, Latin small
+ letters &ldquo;<code>a</code>&rdquo;&ndash;&ldquo;<code>z</code>&rdquo;,
+ digits &ldquo;<code>0</code>&rdquo;&ndash;&ldquo;<code>9</code>&rdquo;,
+ &ldquo;<code>+</code>&rdquo;, &ldquo;<code>-</code>&rdquo;, and
+ &ldquo;<code>.</code>&rdquo;. A scheme&nbsp;<var>s</var> is transformed into
+ a string&nbsp;<var>s</var>&prime; character-by-character, by translating
+ Lating capital letters to their small counterparts, translating
+ &ldquo;<code>+</code>&rdquo; to &ldquo;<code>PLUS</code>&rdquo;,
+ &ldquo;<code>-</code>&rdquo; to &ldquo;<code>HYPHEN</code>&rdquo;,
+ &ldquo;<code>.</code>&rdquo; to &ldquo;<code>DOT</code>&rdquo;, and copying
+ Latin small letters and digits unchanged. If the component context used
+ while creating this <code>UriReferenceFactory</code> instance offers a
+ service manager, and there is a service available at that service manager
+ whose name is the concatenation of
+ &ldquo;<code>com.sun.star.uri.UriSchemeParser_</code>&rdquo; and
+ <var>s</var>&prime;, then that service is used. It is an error if that
+ service does not support
+ <type scope="com::sun::star::uri">XUriSchemeParser</type>.</p>
+
+ @since OOo 2.0.0
+ */
+published service UriReferenceFactory: XUriReferenceFactory;
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/UriSchemeParser_vndDOTsunDOTstarDOTexpand.idl b/udkapi/com/sun/star/uri/UriSchemeParser_vndDOTsunDOTstarDOTexpand.idl
new file mode 100644
index 000000000000..b0115810fb8a
--- /dev/null
+++ b/udkapi/com/sun/star/uri/UriSchemeParser_vndDOTsunDOTstarDOTexpand.idl
@@ -0,0 +1,58 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_UriSchemeParser_vndDOTsunDOTstarDOTexpand_idl__
+#define __com_sun_star_uri_UriSchemeParser_vndDOTsunDOTstarDOTexpand_idl__
+
+module com { module sun { module star { module uri {
+
+published interface XUriSchemeParser;
+
+/**
+ parses textual representations of absolute &ldquo;vnd.sun.star.expand&rdquo;
+ URLs.
+
+ <p>The argument <code>scheme</code> of method
+ <member scope="com::sun::star::uri">XUriSchemeParser::parse</member> must
+ always be equal to the <atom>string</atom>
+ <code>"vnd.sun.star.expand"</code>, ignoring case. The objects returned by
+ <member scope="com::sun::star::uri">XUriSchemeParser::parse</member>
+ implement
+ <type scope="com::sun::star::uri">XVndSunStarExpandUrlReference</type>.</p>
+
+ <p>This service is not intended to be instantiated directly by client code.
+ Rather, it should be used indirectly through the
+ <type scope="com::sun::star::uri">UriReferenceFactory</type> service.</p>
+
+ @since OOo 2.3
+ */
+published service UriSchemeParser_vndDOTsunDOTstarDOTexpand: XUriSchemeParser
+{};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/UriSchemeParser_vndDOTsunDOTstarDOTscript.idl b/udkapi/com/sun/star/uri/UriSchemeParser_vndDOTsunDOTstarDOTscript.idl
new file mode 100644
index 000000000000..50da8154e43a
--- /dev/null
+++ b/udkapi/com/sun/star/uri/UriSchemeParser_vndDOTsunDOTstarDOTscript.idl
@@ -0,0 +1,58 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_UriSchemeParser_vndDOTsunDOTstarDOTscript_idl__
+#define __com_sun_star_uri_UriSchemeParser_vndDOTsunDOTstarDOTscript_idl__
+
+module com { module sun { module star { module uri {
+
+published interface XUriSchemeParser;
+
+/**
+ parses textual representations of absolute &ldquo;vnd.sun.star.script&rdquo;
+ URLs.
+
+ <p>The argument <code>scheme</code> of method
+ <member scope="com::sun::star::uri">XUriSchemeParser::parse</member> must
+ always be equal to the <atom>string</atom>
+ <code>"vnd.sun.star.script"</code>, ignoring case. The objects returned by
+ <member scope="com::sun::star::uri">XUriSchemeParser::parse</member>
+ implement
+ <type scope="com::sun::star::uri">XVndSunStarScriptUrlReference</type>.</p>
+
+ <p>This service is not intended to be instantiated directly by client code.
+ Rather, it should be used indirectly through the
+ <type scope="com::sun::star::uri">UriReferenceFactory</type> service.</p>
+
+ @since OOo 2.0.0
+ */
+published service UriSchemeParser_vndDOTsunDOTstarDOTscript: XUriSchemeParser
+{};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/VndSunStarPkgUrlReferenceFactory.idl b/udkapi/com/sun/star/uri/VndSunStarPkgUrlReferenceFactory.idl
new file mode 100644
index 000000000000..f652851cf280
--- /dev/null
+++ b/udkapi/com/sun/star/uri/VndSunStarPkgUrlReferenceFactory.idl
@@ -0,0 +1,45 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_VndSunStarPkgUrlReferenceFactory_idl__
+#define __com_sun_star_uri_VndSunStarPkgUrlReferenceFactory_idl__
+
+module com { module sun { module star { module uri {
+
+published interface XVndSunStarPkgUrlReferenceFactory;
+
+/**
+ creates &ldquo;vnd.sun.star.pkg&rdquo; URL references.
+
+ @since OOo 2.0.0
+ */
+published service VndSunStarPkgUrlReferenceFactory:
+ XVndSunStarPkgUrlReferenceFactory;
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XExternalUriReferenceTranslator.idl b/udkapi/com/sun/star/uri/XExternalUriReferenceTranslator.idl
new file mode 100644
index 000000000000..3dc6b8bfca77
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XExternalUriReferenceTranslator.idl
@@ -0,0 +1,91 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_XExternalUriReferenceTranslator_idl__
+#define __com_sun_star_uri_XExternalUriReferenceTranslator_idl__
+
+#include <com/sun/star/uno/XInterface.idl>
+
+module com { module sun { module star { module uri {
+
+/**
+ translates between external and internal URI references.
+
+ <p>Some URI schemes leave unspecified important aspects of how to interpret
+ URIs of those schemes. For example, it is unspecified for &ldquo;file&rdquo;
+ URLs how to map the byte sequences that constitute the path segments of a
+ &ldquo;file&rdquo; URL to filenames on a given platform: The UNO environment
+ always assumes that path segments of &ldquo;file&rdquo; URLs represent
+ UTF-8&ndash;encoded strings (which have to be mapped to filenames in a
+ platform-specific way), while other applications typically assume that path
+ segments of &ldquo;file&rdquo; URLs directly represent a platform's
+ byte-sequence filenames. This interface offers methods to translate between
+ such <dfn>internal</dfn> URIs (e.g., UTF-8&ndash;encoded &ldquo;file&rdquo;
+ URLs used within the UNO environment) and <dfn>external</dfn> URIs (e.g.,
+ byte-sequence&ndash;oriented &ldquo;file&rdquo; URLs used by other
+ applications). Typically, only &ldquo;file&rdquo; URLs are affected by this
+ translation.</p>
+
+ <p>Since the translation process is based on URI schemes, relative URI
+ references (that do not include a scheme) are left unmodified by the
+ translation process.</p>
+
+ @since OOo 2.0.0
+ */
+published interface XExternalUriReferenceTranslator {
+ /**
+ returns the internal counterpart of an external URI reference.
+
+ @param externalUriReference
+ an external URI reference.
+
+ @returns
+ the internal counterpart of the given external URI reference. An empty
+ string is returned if the given external URI reference either is an empty
+ string or cannot be converted (for example, because it contains illegal
+ characters).
+ */
+ string translateToInternal([in] string externalUriReference);
+
+ /**
+ returns the external counterpart of an internal URI reference.
+
+ @param internalUriReference
+ an internal URI reference.
+
+ @returns
+ the external counterpart of the given internal URI reference. An empty
+ string is returned if the given internal URI reference either is an empty
+ string or cannot be converted (for example, because it contains illegal
+ characters).
+ */
+ string translateToExternal([in] string internalUriReference);
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XUriReference.idl b/udkapi/com/sun/star/uri/XUriReference.idl
new file mode 100644
index 000000000000..79ad88f47a1c
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XUriReference.idl
@@ -0,0 +1,231 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_XUriReference_idl__
+#define __com_sun_star_uri_XUriReference_idl__
+
+#include <com/sun/star/uno/XInterface.idl>
+
+module com { module sun { module star { module uri {
+
+/**
+ represents generic, mutable URI references.
+
+ <p>See <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC&nbsp;2396</a> for a
+ description of URI references and related terms.</p>
+
+ <p>This interface only handles generic URI references (both absolute and
+ relative). For specific URI schemes, there will be additional interfaces
+ that offer extra, scheme-specific functionality.</p>
+
+ @see com::sun::star::uri::UriReferenceFactory
+ which allows to create URI reference objects that support
+ <type scope="com::sun::star::uri">XUriReference</type> and additional,
+ scheme-specific interfaces.
+
+ @since OOo 2.0.0
+ */
+published interface XUriReference: com::sun::star::uno::XInterface {
+ /**
+ returns the textual representation of the complete URI reference.
+
+ @returns
+ the textual representation of the complete URI reference. The exact
+ spelling of the URI reference is retained.
+ */
+ string getUriReference();
+
+ /**
+ returns whether this URI reference is absolute or relative.
+
+ @returns
+ <TRUE/> if this URI reference is absolute, <FALSE/> if it is relative.
+ */
+ boolean isAbsolute();
+
+ /**
+ returns the scheme part of this (absolute) URI reference.
+
+ @returns
+ the textual representation of the scheme part (with the exact spelling
+ retained; without the delimiting &ldquo;<code>:</code>&rdquo;), if this
+ is an absolute URI reference; otherwise, an empty <atom>string</atom> is
+ returned.
+ */
+ string getScheme();
+
+ /**
+ returns the scheme-specific part of this URI reference.
+
+ <p>For an absolute URI reference, the scheme-specific part is everything
+ after the scheme part and the delimiting &ldquo;<code>:</code>&rdquo;,
+ and before the optional &ldquo;<code>#</code>&rdquo; and fragment part.
+ For a relative URI reference, the scheme-specific part is everything
+ before the optional &ldquo;<code>#</code>&rdquo; and fragment part.</p>
+
+ @returns
+ the textual representation of the scheme-specific part (with the exact
+ spelling retained).
+ */
+ string getSchemeSpecificPart();
+
+ /**
+ returns whether this URI reference is hierarchical or opaque.
+
+ <p>An absolute URI reference is hierarchical if its scheme-specific part
+ starts with &ldquo;<code>/</code>&rdquo;. A relative URI reference is
+ always hierarchical.</p>
+
+ @returns
+ <TRUE/> if this URI reference is hierarchical, <FALSE/> if it is opaque.
+ */
+ boolean isHierarchical();
+
+ /**
+ returns whether this (hierarchical) URI reference has an authority part.
+
+ @returns
+ <TRUE/> if this URI reference is hierarchical and has an authority part.
+ */
+ boolean hasAuthority();
+
+ /**
+ returns the authority part of this (hierarchical) URI reference.
+
+ @returns
+ the textual representation of the authority part (with the exact spelling
+ retained), if this is a hierarchical URI reference that has an authority
+ part; otherwise, an empty <atom>string</atom> is returned.
+ */
+ string getAuthority();
+
+ /**
+ returns the path part of this URI reference.
+
+ @returns
+ the textual representation of the path part (with the exact spelling
+ retained), if this is a hierarchical URI reference; for an opaque URI
+ reference, the scheme-specific part (with the exact spelling retained) is
+ returned.
+ */
+ string getPath();
+
+ /**
+ returns whether this (relative) URI reference has a relative path.
+
+ @returns
+ <TRUE/> if this URI reference is relative and has a relative path.
+ */
+ boolean hasRelativePath();
+
+ /**
+ returns the number of path segments of this (hierarchical) URI reference.
+
+ <p>For an opaque URI reference, and for a hierarchical URI reference with
+ an empty path, the number of path segments is zero. For a hierarchical
+ URI reference with an absolute, non-empty path, the number of path
+ segments equals the number of &ldquo;<code>/</code>&rdquo; delimiters.
+ For a hierarchical URI reference with a relative, non-empty path, the
+ number of path segments equals the number of &ldquo;<code>/</code>&rdquo;
+ delimiters, plus one.</p>
+
+ @returns
+ the number of path segments.
+ */
+ long getPathSegmentCount();
+
+ /**
+ returns a given path segment of this (hierarchical) URI reference.
+
+ @param index
+ the index of the path segment, starting at zero.
+
+ @returns
+ the textual representation of the given path segment (with the exact
+ spelling retained, without any delimiting &ldquo;<code>/</code>&rdquo;),
+ if this URI reference is hierarchical and has that many path segments;
+ otherwise, and in particular if <code>index</code> is negative, an empty
+ <atom>string</atom> is returned.
+ */
+ string getPathSegment([in] long index);
+
+ /**
+ returns whether this (hierarchical) URI reference has a query part.
+
+ @returns
+ <TRUE/> if this URI reference is hierarchical and has a query part.
+ */
+ boolean hasQuery();
+
+ /**
+ returns the query part of this (hierarchical) URI reference.
+
+ @returns
+ the textual representation of the query part (with the exact spelling
+ retained; without the delimiting &ldquo;<code>?</code>&rdquo;), if this
+ is a hierarchical URI reference that has a query part; otherwise, an
+ empty <atom>string</atom> is returned.
+ */
+ string getQuery();
+
+ /**
+ returns whether this URI reference has a fragment part.
+
+ @returns
+ <TRUE/> if this URI reference has a fragment part.
+ */
+ boolean hasFragment();
+
+ /**
+ returns the fragment part of this URI reference.
+
+ @returns
+ the textual representation of the fragment part (with the exact spelling
+ retained; without the delimiting &ldquo;<code>#</code>&rdquo;), if this
+ is a URI reference that has a fragment part; otherwise, an empty
+ <atom>string</atom> is returned.
+ */
+ string getFragment();
+
+ /**
+ sets the fragment part of this URI reference.
+
+ @param fragment
+ the textual representation of the new fragment part. The exact spelling
+ will be preserved, and no escaping is performed.
+ */
+ void setFragment([in] string fragment);
+
+ /**
+ clears the fragment part of this URI reference.
+ */
+ void clearFragment();
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XUriReferenceFactory.idl b/udkapi/com/sun/star/uri/XUriReferenceFactory.idl
new file mode 100644
index 000000000000..bd62235b985d
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XUriReferenceFactory.idl
@@ -0,0 +1,163 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_XUriReferenceFactory_idl__
+#define __com_sun_star_uri_XUriReferenceFactory_idl__
+
+#include <com/sun/star/uno/XInterface.idl>
+#include <com/sun/star/uri/RelativeUriExcessParentSegments.idl>
+#include <com/sun/star/uri/XUriReference.idl>
+
+module com { module sun { module star { module uri {
+
+/**
+ creates URI references.
+
+ <p>See <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC&nbsp;2396</a> for a
+ description of URI references and related terms.</p>
+
+ @since OOo 2.0.0
+ */
+published interface XUriReferenceFactory: com::sun::star::uno::XInterface {
+ /**
+ parses the textual representation of a URI reference.
+
+ @param uriReference
+ the textual representation of a URI reference.
+
+ @returns
+ an object that supports
+ <type scope="com::sun::star::uri">XUriReference</type> (and possibly also
+ additional, scheme-specific interfaces), if the given input can be parsed
+ into a URI reference; otherwise, <NULL/> is returned.
+ */
+ XUriReference parse([in] string uriReference);
+
+ /**
+ resolves a relative URI reference to absolute form.
+
+ @param baseUriReference
+ the base URI reference. If the given <code>uriReference</code> is a
+ same-document reference, <code>baseUriReference</code> is used as a
+ reference to the current document.
+
+ @param uriReference
+ any URI reference. Backwards-compatible relative URI references starting
+ with a scheme component (see RFC&nbsp;2396, Section&nbsp;5.2,
+ step&nbsp;3) are not supported; instead, they are interpreted as absolute
+ URI references.
+
+ @param processSpecialBaseSegments
+ if <TRUE/>, special segments (&ldquo;<code>.</code>&rdquo; and
+ &ldquo;<code>..</code>&rdquo;) within the path of the base URI (except
+ for the last, cut-off segment) are processed as suggested by
+ RFC&nbsp;2396. If <FALSE/>, special segments within the path of the base
+ URI are treated like ordinary segments.
+
+ @param excessParentSegments
+ details how excess special parent segments
+ (&ldquo;<code>..</code>&rdquo;) are handled.
+
+ @returns
+ a fresh object that supports
+ <type scope="com::sun::star::uri">XUriReference</type> (and possibly also
+ additional, scheme-specific interfaces), if the given
+ <code>uriReference</code> is either already absolute, or can be resolved
+ to an absolute URI reference, relative to the given
+ <code>baseUriReference</code>; otherwise, <NULL/> is returned.
+ Especially, if <code>baseUriReference</code> is <NULL/>, or is not an
+ absolute, hierarchical URI reference, or if <code>uriReference</code> is
+ <NULL/>, then <NULL/> is always returned.
+ */
+ XUriReference makeAbsolute(
+ [in] XUriReference baseUriReference, [in] XUriReference uriReference,
+ [in] boolean processSpecialBaseSegments,
+ [in] RelativeUriExcessParentSegments excessParentSegments);
+
+ /**
+ changes an absolute URI refrence to relative form.
+
+ @param baseUriReference
+ the base URI reference.
+
+ @param uriReference
+ any URI reference.
+
+ @param preferAuthorityOverRelativePath
+ controls how a relative URI reference is generated when both
+ <code>baseUriReference</code> (e.g.,
+ &ldquo;<code>scheme://auth/a/b</code>&rdquo;) and
+ <code>uriReference</code> (e.g.,
+ &ldquo;<code>scheme://auth//c/d</code>&rdquo;) have the same scheme and
+ authority components, and the path component of <code>uriReference</code>
+ starts with &ldquo;<code>//</code>&rdquo;. If <TRUE/>, the generated
+ relative URI reference includes an authority component (e.g.,
+ &ldquo;<code>//auth//c/d</code>&rdquo;); if <FALSE/>, the generated
+ relative URI reference has a relative path (e.g.,
+ &ldquo;<code>..//c/d</code>&rdquo;).
+
+ @param preferAbsoluteOverRelativePath
+ controls how a relative URI reference is generated when both
+ <code>baseUriReference</code> (e.g.,
+ &ldquo;<code>scheme://auth/a/b</code>&rdquo;) and
+ <code>uriReference</code> (e.g.,
+ &ldquo;<code>scheme://auth/c/d</code>&rdquo;) have the same scheme and
+ authority components (if present), but share no common path segments. If
+ <TRUE/>, the generated relative URI reference has an absolute path (e.g.,
+ &ldquo;<code>/c/d</code>&rdquo;); if <FALSE/>, the generated relative URI
+ reference has a relative path (e.g., &ldquo;<code>../c/d</code>&rdquo;).
+
+ @param encodeRetainedSpecialSegments
+ if <TRUE/>, special segments (&ldquo;<code>.</code>&rdquo; and
+ &ldquo;<code>..</code>&rdquo;) that are already present in the path
+ component of the given <code>uriReference</code> and which end up in a
+ relative path returned from this method, are encoded (as
+ &ldquo;<code>%2E</code>&rdquo; and &ldquo;<code>%2E%2E</code>&rdquo;,
+ respectively).
+
+ @returns
+ a fresh object that supports
+ <type scope="com::sun::star::uri">XUriReference</type>, if the given
+ <code>uriReference</code> is either already relative, or is not
+ hierarchical, or is of a different scheme than the given
+ <code>baseUriReference</code>, or can be changed to a relative URI
+ reference, relative to the given <code>baseUriReference</code>;
+ otherwise, <NULL/> is returned. Especially, if
+ <code>baseUriReference</code> is <NULL/>, or is not an absolute,
+ hierarchical URI reference, or if <code>uriReference</code> is <NULL/>,
+ then <NULL/> is always returned.
+ */
+ XUriReference makeRelative(
+ [in] XUriReference baseUriReference, [in] XUriReference uriReference,
+ [in] boolean preferAuthorityOverRelativePath,
+ [in] boolean preferAbsoluteOverRelativePath,
+ [in] boolean encodeRetainedSpecialSegments);
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XUriSchemeParser.idl b/udkapi/com/sun/star/uri/XUriSchemeParser.idl
new file mode 100644
index 000000000000..61a8173d9ab4
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XUriSchemeParser.idl
@@ -0,0 +1,75 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_XUriSchemeParser_idl__
+#define __com_sun_star_uri_XUriSchemeParser_idl__
+
+#include <com/sun/star/uno/XInterface.idl>
+#include <com/sun/star/uri/XUriReference.idl>
+
+module com { module sun { module star { module uri {
+
+/**
+ parses textual representations of absolute URIs.
+
+ <p>See <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC&nbsp;2396</a> for a
+ description of URIs and related terms.</p>
+
+ @since OOo 2.0.0
+ */
+published interface XUriSchemeParser: com::sun::star::uno::XInterface {
+ /**
+ parses the textual representation of an absolute URI.
+
+ <p>This method is used to parse URIs (with no fragment part), not URI
+ references (with an optional fragment part).</p>
+
+ <p>If an object is returned, the behaviour of its
+ <type scope="com::sun::star::uri">XUriReference</type> methods must
+ reflect the fact that the object represents an absolute URI reference
+ with the given scheme and scheme-specific part, and without a fragment
+ part.</p>
+
+ @param scheme
+ the textual representation of the scheme part (without the delimiting
+ &ldquo;<code>:</code>&rdquo;).
+
+ @param uriReference
+ the textual representation of the scheme-specific part.
+
+ @returns
+ an object that supports
+ <type scope="com::sun::star::uri">XUriReference</type> (and possibly also
+ additional, scheme-specific interfaces), if the given input can be parsed
+ into an absolute URI; otherwise, <NULL/> is returned.
+ */
+ XUriReference parse([in] string scheme, [in] string schemeSpecificPart);
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XVndSunStarExpandUrl.idl b/udkapi/com/sun/star/uri/XVndSunStarExpandUrl.idl
new file mode 100644
index 000000000000..8d3d339ce404
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XVndSunStarExpandUrl.idl
@@ -0,0 +1,77 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_XVndSunStarExpandUrl_idl__
+#define __com_sun_star_uri_XVndSunStarExpandUrl_idl__
+
+#include "com/sun/star/lang/IllegalArgumentException.idl"
+#include "com/sun/star/uno/XInterface.idl"
+
+module com { module sun { module star { module util {
+ published interface XMacroExpander;
+}; }; }; };
+
+module com { module sun { module star { module uri {
+
+/**
+ represents absolute &ldquo;vnd.sun.star.expand&rdquo; URLs.
+
+ <p>These URLs are of the form<br/>
+ &emsp;<var>vnd-sun-star-expand-url</var> =
+ <code>"VND.SUN.STAR.EXPAND:"</code> <var>opaque_part</var><br/>
+ where the <var>opaque_part</var> is an UTF-8 string as described in
+ <a href="http://udk.openoffice.org/common/man/concept/micro_deployment.html">
+ <cite>Bootstrap Arguments and Micro Deployment</cite></a>. See
+ <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC&nbsp;2396</a>,
+ <a href="http://www.ietf.org/rfc/rfc2732.txt">RFC&nbsp;2732</a>, and
+ <a href="http://www.ietf.org/rfc/rfc2234.txt">RFC&nbsp;2234</a> for
+ details.</p>
+
+ @since OOo 2.3
+ */
+published interface XVndSunStarExpandUrl {
+ /**
+ returns the expanded content of this URL.
+
+ @param expander
+ a macro expander; must not be <NULL/>.
+
+ @returns
+ the expanded content of this URL.
+
+ @throws com::sun::star::lang::IllegalArgumentException
+ if calling <member
+ scope="com::sun::star::util">XMacroExpander::expandMacros</member> on
+ <code>expander</code> raises any such exception.
+ */
+ string expand([in] com::sun::star::util::XMacroExpander expander)
+ raises (com::sun::star::lang::IllegalArgumentException);
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XVndSunStarExpandUrlReference.idl b/udkapi/com/sun/star/uri/XVndSunStarExpandUrlReference.idl
new file mode 100644
index 000000000000..57e9e28e28af
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XVndSunStarExpandUrlReference.idl
@@ -0,0 +1,59 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_VndSunStarExpandUrlReference_idl__
+#define __com_sun_star_uri_VndSunStarExpandUrlReference_idl__
+
+#include "com/sun/star/uri/XUriReference.idl"
+#include "com/sun/star/uri/XVndSunStarExpandUrl.idl"
+
+module com { module sun { module star { module uri {
+
+/**
+ represents absolute &ldquo;vnd.sun.star.expand&rdquo; URL references.
+
+ @since OOo 2.3
+ */
+published interface XVndSunStarExpandUrlReference {
+ /**
+ represents the generic features of the URL reference.
+
+ <p>The behaviour of the methods of this interface will always reflect the
+ fact that the represented URI reference is an absolute
+ &ldquo;vnd.sun.star.expand&rdquo; URL reference.</p>
+ */
+ interface XUriReference;
+
+ /**
+ represents the scheme-specific features of the URL reference.
+ */
+ interface XVndSunStarExpandUrl;
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XVndSunStarPkgUrlReferenceFactory.idl b/udkapi/com/sun/star/uri/XVndSunStarPkgUrlReferenceFactory.idl
new file mode 100644
index 000000000000..e6db55f9905b
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XVndSunStarPkgUrlReferenceFactory.idl
@@ -0,0 +1,61 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_XVndSunStarPkgUrlReferenceFactory_idl__
+#define __com_sun_star_uri_XVndSunStarPkgUrlReferenceFactory_idl__
+
+#include <com/sun/star/uno/XInterface.idl>
+
+module com { module sun { module star { module uri {
+
+published interface XUriReference;
+
+/**
+ creates &ldquo;vnd.sun.star.pkg&rdquo; URL references.
+
+ @since OOo 2.0.0
+ */
+published interface XVndSunStarPkgUrlReferenceFactory {
+ /**
+ creates a new &ldquo;vnd.sun.star.pkg&rdquo; URL reference.
+
+ <p>The returned URL reference has the given authority, an empty path, and
+ no fragment.</p>
+
+ @param authority the authority of the created URL reference; must not be
+ <NULL/>, and should be an absolute URI reference with no fragment
+
+ @return a new &ldquo;vnd.sun.star.pkg&rdquo; URL reference, or <NULL/> if
+ the given authority is either not an absolute URI reference or has a
+ fragment
+ */
+ XUriReference createVndSunStarPkgUrlReference([in] XUriReference authority);
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XVndSunStarScriptUrl.idl b/udkapi/com/sun/star/uri/XVndSunStarScriptUrl.idl
new file mode 100644
index 000000000000..753ed90b1cef
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XVndSunStarScriptUrl.idl
@@ -0,0 +1,137 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_XVndSunStarScriptUrl_idl__
+#define __com_sun_star_uri_XVndSunStarScriptUrl_idl__
+
+#include <com/sun/star/lang/IllegalArgumentException.idl>
+#include <com/sun/star/uno/XInterface.idl>
+
+module com { module sun { module star { module uri {
+
+/**
+ represents absolute &ldquo;vnd.sun.star.script&rdquo; URLs.
+
+ <p>These URLs are of the form<br/>
+ &emsp;<var>vnd-sun-star-script-url</var> =
+ <code>"VND.SUN.STAR.SCRIPT:"</code> <var>name</var> [<code>"?"</code>
+ <var>parameter</var> *(<code>"&"</code> <var>parameter</var>)]<br/>
+ &emsp;<var>name</var> = 1*<var>schar</var><br/>
+ &emsp;<var>parameter</var> = <var>key</var> <code>"="</code>
+ <var>value</var><br/>
+ &emsp;<var>key</var> = 1*<var>schar</var><br/>
+ &emsp;<var>value</var> = *<var>schar</var><br/>
+ &emsp;<var>schar</var> = <var>unreserved</var> / <var>escaped</var> /
+ <code>"$"</code> / <code>"+"</code> / <code>","</code> / <code>":"</code> /
+ <code>";"</code> / <code>"@"</code> / <code>"["</code> /
+ <code>"]"</code><br/>
+ See <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC&nbsp;2396</a>,
+ <a href="http://www.ietf.org/rfc/rfc2732.txt">RFC&nbsp;2732</a>, and
+ <a href="http://www.ietf.org/rfc/rfc2234.txt">RFC&nbsp;2234</a> for
+ details.</p>
+
+ <p>The names, keys, and values are arbitrary Unicode strings (non-empty
+ Unicode strings in the case of names and keys), encoded as UTF-8 byte
+ sequences. It is an error if any of them does not represent a valid UTF-8
+ byte sequence. Keys are compared for equality character-by-character,
+ without considering case folding or normalization. There may be multiple
+ parameters with equal keys.</p>
+
+ @since OOo 2.0.0
+ */
+published interface XVndSunStarScriptUrl: com::sun::star::uno::XInterface {
+ /**
+ returns the name part of this URL.
+
+ @returns
+ the non-escaped value of the name part.
+ */
+ string getName();
+
+ /**
+ sets the name part of this URL.
+
+ @param name
+ specifies the non-escaped new name part of the URL.
+
+ @throws ::com::sun::star::lang::IllegalArgumentException
+ if <arg>name</arg> is empty
+
+ @since OOo 3.0
+ */
+ void setName([in] string name)
+ raises ( ::com::sun::star::lang::IllegalArgumentException );
+
+ /**
+ returns whether this URL has a parameter with a given key.
+
+ @param key
+ a non-escaped key.
+
+ @returns
+ <TRUE/> if this URL has at least one parameter with the given key. In
+ particular, if <code>key</code> is an empty <atom>string</atom>, <FALSE/>
+ is returned.
+ */
+ boolean hasParameter([in] string key);
+
+ /**
+ returns the value of a parameter with a given key.
+
+ @param key
+ a non-escaped key.
+
+ @returns
+ the non-escaped value of the first parameter with the given key. If
+ there is no parameter with the given key, or if <code>key</code> is an
+ empty <atom>string</atom>, an empty <atom>string</atom> is returned.
+ */
+ string getParameter([in] string key);
+
+ /**
+ sets the value of a parameter with a given key.
+
+ @param key
+ a non-escaped key
+
+ @param value
+ the non-escaped value to be set for the parameter. If there already is a
+ parameter with this key, the value of its first appearance will be replaced.
+ Otherwise, a parameter with the given key/value will be appended.
+
+ @throws ::com::sun::star::lang::IllegalArgumentException
+ if <arg>key</arg> is empty
+
+ @since OOo 3.0
+ */
+ void setParameter( [in] string key, [in] string value )
+ raises ( ::com::sun::star::lang::IllegalArgumentException );
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/XVndSunStarScriptUrlReference.idl b/udkapi/com/sun/star/uri/XVndSunStarScriptUrlReference.idl
new file mode 100644
index 000000000000..4b3ef2eae4b5
--- /dev/null
+++ b/udkapi/com/sun/star/uri/XVndSunStarScriptUrlReference.idl
@@ -0,0 +1,57 @@
+/*************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2000, 2010 Oracle and/or its affiliates.
+ *
+ * OpenOffice.org - a multi-platform office productivity suite
+ *
+ * This file is part of OpenOffice.org.
+ *
+ * OpenOffice.org is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License version 3
+ * only, as published by the Free Software Foundation.
+ *
+ * OpenOffice.org is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License version 3 for more details
+ * (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * version 3 along with OpenOffice.org. If not, see
+ * <http://www.openoffice.org/license.html>
+ * for a copy of the LGPLv3 License.
+ *
+ ************************************************************************/
+
+#ifndef __com_sun_star_uri_VndSunStarScriptUrlReference_idl__
+#define __com_sun_star_uri_VndSunStarScriptUrlReference_idl__
+
+#include <com/sun/star/uri/XUriReference.idl>
+#include <com/sun/star/uri/XVndSunStarScriptUrl.idl>
+
+module com { module sun { module star { module uri {
+
+/**
+ represents absolute &ldquo;vnd.sun.star.script&rdquo; URL references.
+ */
+published interface XVndSunStarScriptUrlReference {
+ /**
+ represents the generic features of the URL reference.
+
+ <p>The behaviour of the methods of this interface will always reflect the
+ fact that the represented URI reference is an absolute
+ &ldquo;vnd.sun.star.script&rdquo; URL reference.</p>
+ */
+ interface XUriReference;
+
+ /**
+ represents the scheme-specific features of the URL reference.
+ */
+ interface XVndSunStarScriptUrl;
+};
+
+}; }; }; };
+
+#endif
diff --git a/udkapi/com/sun/star/uri/makefile.mk b/udkapi/com/sun/star/uri/makefile.mk
new file mode 100644
index 000000000000..8b9a0b7a2b81
--- /dev/null
+++ b/udkapi/com/sun/star/uri/makefile.mk
@@ -0,0 +1,54 @@
+#*************************************************************************
+#
+# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+#
+# Copyright 2000, 2010 Oracle and/or its affiliates.
+#
+# OpenOffice.org - a multi-platform office productivity suite
+#
+# This file is part of OpenOffice.org.
+#
+# OpenOffice.org is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License version 3
+# only, as published by the Free Software Foundation.
+#
+# OpenOffice.org is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Lesser General Public License version 3 for more details
+# (a copy is included in the LICENSE file that accompanied this code).
+#
+# You should have received a copy of the GNU Lesser General Public License
+# version 3 along with OpenOffice.org. If not, see
+# <http://www.openoffice.org/license.html>
+# for a copy of the LGPLv3 License.
+#
+#*************************************************************************
+
+PRJ := ..$/..$/..$/..
+PRJNAME := api
+TARGET := cssuri
+
+PACKAGE := com$/sun$/star$/uri
+
+.INCLUDE: $(PRJ)$/util$/makefile.pmk
+
+IDLFILES = \
+ ExternalUriReferenceTranslator.idl \
+ RelativeUriExcessParentSegments.idl \
+ UriReferenceFactory.idl \
+ UriSchemeParser_vndDOTsunDOTstarDOTexpand.idl \
+ UriSchemeParser_vndDOTsunDOTstarDOTscript.idl \
+ VndSunStarPkgUrlReferenceFactory.idl \
+ XExternalUriReferenceTranslator.idl \
+ XUriReference.idl \
+ XUriReferenceFactory.idl \
+ XUriSchemeParser.idl \
+ XVndSunStarExpandUrl.idl \
+ XVndSunStarExpandUrlReference.idl \
+ XVndSunStarPkgUrlReferenceFactory.idl \
+ XVndSunStarScriptUrl.idl \
+ XVndSunStarScriptUrlReference.idl
+
+.INCLUDE: target.mk
+.INCLUDE: $(PRJ)$/util$/target.pmk