InterfaceClient: ECom interface client example code in ECom example code

InterfaceClient: interface client example code
Example code
Found in: examples\SysLibs\ECom\InterfaceClient\

The files reproduced here are the main files contained in the examples directory. Some extra files may be needed to run the examples, and these will be found in the appropriate examples directory.

// InterfaceClient.h
//
// Copyright (c) 2001 Symbian Ltd. All rights reserved.

#ifndef __CINTERFACECLIENT_H
#define __CINTERFACECLIENT_H

#include

// Example ECOM client that uses the InterfaceImplementation plug-ins
// through the InterfaceDefinition (CExampleInterface) interface
class TInterfaceClient
{
public:
// Gets the default implementation of CExampleInterface
void GetDefaultL();

// Gets a CExampleInterface implementation by requesting
// a specific types of capability
void GetBySpecificationL();

// Gets all the CExampleInterface implementations
void GetByDiscoveryL();
};

#endif
// InterfaceClient.cpp
//
// Copyright (c) 2001 Symbian Ltd. All rights reserved.

#include

#include

#include "CommonFramework.h"
#include "InterfaceClient.h"

// Utility clean up function
void CleanupEComArray(TAny* aArray);

// do the example
LOCAL_C void doExampleL()
{
_LIT(KText,"ECom client example\n\n");
console->Printf(KText);

TInterfaceClient client;
client.GetDefaultL();
client.GetBySpecificationL();
client.GetByDiscoveryL();

REComSession::FinalClose();
}

void TInterfaceClient::GetDefaultL()
{
_LIT(KText,"Case 1: getting the default implementation\n");
console->Printf(KText);

// Get the default implementation and call its method
CExampleInterface* ex1 = CExampleInterface::NewL();
CleanupStack::PushL(ex1);
TBuf<100> buf;
ex1 -> DoMethodL(buf);
CleanupStack::PopAndDestroy(); //ex1

// Print results
console -> Printf(buf);
}

void TInterfaceClient::GetBySpecificationL()
{
_LIT(KText,"\nCase 2: getting an implementation by specification\n");
console->Printf(KText);

// Prepare data to pass to implementation
CExampleInterface::TExampleInterfaceInitParams p;
p.integer = 0;
_LIT(KMsg1,"Data in value: %d\n");
console -> Printf(KMsg1,p.integer);

// Get the implementation that has a data identifier text/xml
_LIT8(KSpec,"text/xml");
CExampleInterface* ex1 = CExampleInterface::NewL(KSpec,p);
CleanupStack::PushL(ex1);
TBuf<100> buf;
ex1 -> DoMethodL(buf);
CleanupStack::PopAndDestroy(); //ex1

// Print results
console -> Printf(buf);
_LIT(KMsg2,"Data out value: %d\n");
console -> Printf(KMsg2,p.integer);
}


void TInterfaceClient::GetByDiscoveryL()
{
_LIT(KText,"\nCase 3: getting all implementations\n");
console->Printf(KText);

// Read info about all implementations into infoArray
RImplInfoPtrArray infoArray;
// Note that a special cleanup function is required to reset and destroy
// all items in the array, and then close it.
TCleanupItem cleanup(CleanupEComArray, &infoArray);
CleanupStack::PushL(cleanup);
CExampleInterface::ListAllImplementationsL(infoArray);

// Loop through each info for each implementation
// and create and use each in turn
CExampleInterface* ex;
TBuf<255> buf;
for (TInt i=0; i< type =" infoArray[i]-">DataType();
type.Set(type.Left(type.Locate('')));
// Need to convert narrow descriptor to be wide in order to print it
buf.Copy(type);
console -> Printf(buf);
console -> Printf(_L(": "));

// Create object of type and call its function
ex = CExampleInterface::NewL(type);
CleanupStack::PushL(ex);
ex -> DoMethodL(buf);
CleanupStack::PopAndDestroy(); //ex

// Print results
console -> Printf(buf);

ex = NULL;
buf.Zero();
}

// Clean up
CleanupStack::PopAndDestroy(); //infoArray, results in a call to CleanupEComArray
}

// CleanupEComArray function is used for cleanup support of locally declared arrays
void CleanupEComArray(TAny* aArray)
{
(static_cast (aArray))->ResetAndDestroy();
(static_cast (aArray))->Close();
}
// InterfaceClient.mmp
//
// Copyright (c) 2001 Symbian Ltd. All rights reserved.

TARGET InterfaceClient.exe
TARGETTYPE exe
UID 0
VENDORID 0x70000001

SOURCEPATH .
SOURCE InterfaceClient.cpp

USERINCLUDE .
USERINCLUDE ..\..\CommonFramework
SYSTEMINCLUDE \Epoc32\include
SYSTEMINCLUDE \Epoc32\include\ecom

LIBRARY euser.lib ECom.lib
The ECom example code is a set of related examples that provide an interface definition, a DLL that contains two implementations of that interface, and a client program that uses the interface.

The examples have a single bld.inf file in Examples\SysLibs\ECom\.

// BLD.INF
// Component description file
//
// Copyright (c) 2001 Symbian Ltd. All rights reserved.

// Export the interface definition
PRJ_EXPORTS
InterfaceDefinition\Interface.h
InterfaceDefinition\Interface.inl

PRJ_MMPFILES
InterfaceImplementation\InterfaceImplementation.mmp
InterfaceClient\InterfaceClient.mmp
InterfaceDefinition\InterfaceDefinition.mmp

--------------------------------------------------------------------------------

Description
InterfaceClient is a simple client program that exercises the interface and implementations provided by the InterfaceDefinition and InterfaceImplementation examples respectively.

Its single class, TInterfaceClient, defines three functions:

GetDefaultL(), which gets the default implementation of the CExampleInterface interface

GetBySpecificationL(), which requests an implementation of the CExampleInterface interface with a specific types of capability

GetByDiscoveryL(), which gets all the implementations on the system of the CExampleInterface interface




--------------------------------------------------------------------------------

Usage
InterfaceClient is a console program (.exe). It does not require any user input.