mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-06 00:55:37 +00:00
95 lines
3.5 KiB
C++
95 lines
3.5 KiB
C++
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
*
|
|
* The contents of this file are subject to the Netscape Public
|
|
* License Version 1.1 (the "License"); you may not use this file
|
|
* except in compliance with the License. You may obtain a copy of
|
|
* the License at http://www.mozilla.org/NPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS
|
|
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
|
|
* implied. See the License for the specific language governing
|
|
* rights and limitations under the License.
|
|
*
|
|
* The Original Code is Mozilla Communicator client code.
|
|
*
|
|
* The Initial Developer of the Original Code is Netscape Communications
|
|
* Corporation. Portions created by Netscape are
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All
|
|
* Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
*/
|
|
|
|
#ifndef nsIScriptNameSpaceManager_h__
|
|
#define nsIScriptNameSpaceManager_h__
|
|
|
|
#include "nscore.h"
|
|
#include "nsString.h"
|
|
#include "nsISupports.h"
|
|
|
|
#define NS_ISCRIPTNAMESPACEMANAGER_IID \
|
|
{0xa6cf90db, 0x15b3, 0x11d2, \
|
|
{0x93, 0x2e, 0x00, 0x80, 0x5f, 0x8a, 0xdd, 0x32}}
|
|
|
|
/**
|
|
* A per script context construct. The namespace manager maintains
|
|
* a mapping between a global symbol or name and a class ID to
|
|
* obtain a factory to use to instantiate a native object.
|
|
*/
|
|
class nsIScriptNameSpaceManager : public nsISupports {
|
|
public:
|
|
NS_DEFINE_STATIC_IID_ACCESSOR(NS_ISCRIPTNAMESPACEMANAGER_IID);
|
|
|
|
/**
|
|
* Used to register a single global symbol or name. The class ID
|
|
* is used to obtain a factory which is used to instantiate
|
|
* the the corresponding native object. The name can represent
|
|
* either an object or a constructor.
|
|
* XXX How do we indicate clashes in registered names?
|
|
*
|
|
* @param aName the name to reflect in the global namespace
|
|
* @param aIID IID used to create a script wrapper
|
|
* @param aCID the class ID used to obtain a factory
|
|
* @param aIsConstructor set to PR_TRUE if the name represents
|
|
* a constructor. PR_FALSE if it is a global object.
|
|
* @result NS_OK if successful
|
|
*/
|
|
NS_IMETHOD RegisterGlobalName(const nsString& aName,
|
|
const nsIID& aIID,
|
|
const nsIID& aCID,
|
|
PRBool aIsConstructor) = 0;
|
|
|
|
/**
|
|
* Used to remove a global symbol or name from the manager.
|
|
*
|
|
* @param aName the name to remove
|
|
* @result NS_OK if successful
|
|
*/
|
|
NS_IMETHOD UnregisterGlobalName(const nsString& aName) = 0;
|
|
|
|
/**
|
|
* Used to look up the manager using a name as a key. The
|
|
* return value is a class ID that can be used to obtain
|
|
* a factory.
|
|
*
|
|
* @param aName the name to use as a key for the lookup
|
|
* @param aIsConstructor out parameter to indicate whether
|
|
* the name refers to an instance or a constructor
|
|
* @param aIID out parameter that returns the ID of the
|
|
* interface to use to create a script wrapper
|
|
* for the newly created instance.
|
|
* @param aCID out parameter that returns the class ID
|
|
* that corresponds to the name
|
|
* @result NS_OK if the lookup succeeded. NS_ERROR_INVALID_ARG
|
|
* if the lookup failed.
|
|
*/
|
|
NS_IMETHOD LookupName(const nsString& aName,
|
|
PRBool& aIsConstructor,
|
|
nsIID& aIID,
|
|
nsIID& aCID) = 0;
|
|
};
|
|
|
|
extern "C" NS_DOM nsresult NS_NewScriptNameSpaceManager(nsIScriptNameSpaceManager** aInstancePtr);
|
|
|
|
#endif /* nsIScriptNameSpaceManager_h__ */
|