User's Guide
Reference Manual
Release Notes
PDF
Top

cosTransactions
User's Guide
Version 1.2.13

Expand All
Contract All

Chapters

- The cosTransactions Application
  - Top of chapter
  - Content Overview
  - Brief Description of the User's Guide
- Introduction to cosTransactions
  - Top of chapter
  - Overview
- Installing cosTransactions
  - Top of chapter
  - Installation Process
- cosTransactions Examples
  - Top of chapter
  - A Tutorial on How to Create a Simple Service
- Resource Skeletons
  - Top of chapter
  - Resource Skeletons

# 5 Resource Skeletons

### 5.1 Resource Skeletons

This chapter provides a skeleton for application Resources. For more information see the Orber documentation.

    %%%-----------------------------------------------------------
    %%% File    : Module_Interface_impl.erl
    %%% Author  :
    %%% Purpose :
    %%% Created :
    %%%-----------------------------------------------------------

    -module('Module_Interface_impl').

    %%--------------- INCLUDES -----------------------------------
    -include_lib("orber/include/corba.hrl").
    -include_lib("cosTransactions/include/CosTransactions.hrl").

    %%--------------- EXPORTS-------------------------------------
    %%- Inherit from CosTransactions::Resource -------------------
    -export([prepare/2,
             rollback/2,
             commit/2,
             commit_one_phase/2,
             forget/2]).

    %%- Inherit from CosTransactions::SubtransactionAwareResource
    -export([commit_subtransaction/3,
             rollback_subtransaction/2]).

    %%--------------- gen_server specific ------------------------
    -export([init/1, terminate/2, code_change/3, handle_info/2]).

    %%------------------------------------------------------------
    %% function : gen_server specific
    %%------------------------------------------------------------
    init(Env) ->
        %% 'trap_exit' optional
        process_flag(trap_exit,true),

        %%--- Possible replies ---
        %% Reply and await next request
        {ok, State}.

        %% Reply and if no more requests within Time the special
        %% timeout message should be handled in the
        %% Module_Interface_impl:handle_info/2 call-back function (use the
        %% IC option {{handle_info, "Module::Interface"}, true}).
        {ok, State, TimeOut}.

         %% Return ignore in order to inform the parent, especially if it is a
         %% supervisor, that the server, as an example, did not start in
         %% accordance with the configuration data.
         ignore.

         %% If the initializing procedure fails, the reason
         %% is supplied as StopReason.
         {stop, StopReason}.

    terminate(Reason, State) ->
        ok.

    code_change(OldVsn, State, Extra) ->
        {ok, NewState}.

    %% If use IC option {{handle_info, "Module::Interface"}, true}
    handle_info(Info, State) ->
         %%--- Possible replies ---
         %% Await the next invocation.
         {noreply, State}.
         %% Stop with Reason.
         {stop, Reason, State}.

    %%- Inherit from CosTransactions::Resource -------------------
    prepare(State) ->

        %%% Do application specific actions here %%%

        %%-- Reply: --
        %% If no data related to the transaction changed.
        {reply, 'VoteReadOnly', State}
        %% .. or (for example):
        {stop, normal, 'VoteReadOnly', State}.

        %% If able to commit
        {reply, 'VoteCommit', State}

        %% If not able to commit
        {reply, 'VoteRollback', State}
        %% .. or (for example):
        {stop, normal, 'VoteRollback', State}.

    rollback(State) ->

        %%% Do application specific actions here %%%

        %%-- Reply: --
        %% If able to rollback successfully
        {reply, ok, State}
        %% .. or (for example):
        {stop, normal, ok, State}.

        %% If Heuristic Decision. Raise exception:
        corba:raise(#'CosTransactions_HeuristicMixed' {})
        corba:raise(#'CosTransactions_HeuristicHazard' {})
        corba:raise(#'CosTransactions_HeuristicCommit'{})

    commit(State) ->

        %%% Do application specific actions here %%%

        %%-- Reply: --
        %% If able to commit successfully
        {reply, ok, State}
        %% .. or (for example):
        {stop, normal, ok, State}.

        %% If the prepare operation never been invoked:
        corba:raise(#'CosTransactions_NotPrepared'{})

        %% If Heuristic Decision. Raise exception:
        corba:raise(#'CosTransactions_HeuristicMixed' {})
        corba:raise(#'CosTransactions_HeuristicHazard' {})
        corba:raise(#'CosTransactions_HeuristicRollback'{})

    commit_one_phase(State) ->

        %%% Do application specific actions here %%%

        %%-- Reply: --
        %% If able to commit successfully
        {reply, ok, State}
        %% .. or (for example):
        {stop, normal, ok, State}.

        %% If fails. Raise exception:
        corba:raise(#'CosTransactions_HeuristicHazard' {})

        %% If able to rollback successfully
        corba:raise(#'CosTransactions_TransactionRolledBack' {})

    forget(State) ->

        %%% Do application specific actions here %%%

        %%-- Reply: --
        {reply, ok, State}.
        %% .. or (for example):
        {stop, normal, ok, State}.

    %%%%%% If the Resource is also supposed to be a     %%%%%%
    %%%%%% SubtransactionAwareResource implement these. %%%%%%

    %%- Inherit from CosTransactions::SubtransactionAwareResource
    commit_subtransaction(State, Parent) ->
        %%% Do application specific actions here %%%

        %%-- Reply: --
        {reply, ok, State}.
        %% .. or (for example):
        {stop, normal, ok, State}.

    rollback_subtransaction(State) ->
        %%% Do application specific actions here %%%

        %%-- Reply: --
        {reply, ok, State}.
        %% .. or (for example):
        {stop, normal, ok, State}.

    %%--------------- END OF MODULE ------------------------------