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

G.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 System;
using Fujitsu.Shunsaku;

class SampleDirectAccessSearch {
  static public void Main( string[] args ) {
    ShunService service = null;

    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[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}", rs.HitCount );
      int i = 0;
      foreach ( ShunRecord record in rs.Records ) {
        ++i;
        Console.WriteLine( "[Result] Item No. {0}", 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 != null && 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 );
    }
  }
}

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>