Interstage Shunsaku Data Manager Application Development Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

I.3.2 Searching Data Using Direct Access Key

The following is a sample program to search data with the direct access key using the C++ .NET.

Data to be Searched

<course>
  <id>0001</id>
  <name>Business negotiation</name>
  <instructor>
    <first-name>Max</first-name>
    <last-name>cameron</last-name>
  </instructor>
  <capacity>40</capacity>
  <current-auditors>30</current-auditors>
</course>

Defined Direct Access Key

key /course/id/text()

An Example of Using the APIs

The following is a sample program using the C++ .NET.

#using <mscorlib.dll>
#using <system.dll>
#using <Fujitsu.Shunsaku.dll>

using namespace System;
using namespace Fujitsu::Shunsaku;

class SampleDirectAccessSearch {
public:
  static void Main( String *args __gc[] ) {
    ShunService *service = 0;

    try {
      // Create ShunService
      service = new ShunService();

      // Connect Shunsaku by specifying the host name and port number
      service->Host = "DirSvr1";
      service->Port = 33101;
      service->ShunsakuFile = "shunsakuFile1";
      service->Connect();

      // Create ShunKeyRequirement object for searching data
      ShunKeyRequirement *keyReq = new ShunKeyRequirement();
      keyReq->KeyName = "key";

      // Add the key to be searched
      keyReq->Records->Add( new ShunRecord() );
      keyReq->Records->get_Item( 0 )->Key = "0001";

      // Specify the search condition and execute the search
      ShunResultSet *rs = service->SearchByKey( keyReq, "/" );

      // Obtain the source information of the direct access key
      Console::WriteLine( "Number of hits  = {0}", __box( rs->HitCount ) );
      int i = 0;
      ShunRecordEnumerator *enumerator = rs->Records->GetEnumerator();
      while ( enumerator->MoveNext() ) {
        ShunRecord *record = enumerator->Current;
        ++i;
        Console::WriteLine( "[Result] Item No. {0}", __box( i ) );
        Console::WriteLine( "Direct access key: {0}", record->Key );
        Console::WriteLine( "Data                :" );
        Console::WriteLine( record->Data );
      }

      // Close the connection to Shunsaku
      service->Disconnect();

    }
    catch ( ShunContinuousException *e ) {
      // Processing to perform if ShunContinuousException occurs
      try {
        if( service != 0 && service->State == ShunConnectionState::Open ) {
          service->Disconnect();
        }
      }
      catch ( ShunException *ex ) {
        Console::WriteLine( "Error message : {0}", ex->Message );
      }
      Console::WriteLine( "Error message : {0}", e->Message );
    }
    catch ( ShunConnectionTerminatedException *e ) {
      // Processing to perform if ShunConnectionTerminatedException occurs
      Console::WriteLine( "Error message : {0}", e->Message );
    }
  }
};

int main() {
  return 
SampleDirectAccessSearch::Main( Environment::GetCommandLineArgs() );
}

Execution Results

Number of hits       = 1
[Result] Item No.1
Direct access key:0001
Data                :
<course>
  <id>0001</id>
  <name>Business negotiation</name>
  <instructor>
    <first-name>Max</first-name>
    <last-name>cameron</last-name>
  </instructor>
  <capacity>40</capacity>
  <current-auditors>30</current-auditors>
</course>