Index: openacs-4/packages/acs-service-contract/www/doc/index.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-service-contract/www/doc/index.adp,v diff -u -r1.7 -r1.8 --- openacs-4/packages/acs-service-contract/www/doc/index.adp 18 May 2018 07:56:07 -0000 1.7 +++ openacs-4/packages/acs-service-contract/www/doc/index.adp 3 Sep 2024 15:37:33 -0000 1.8 @@ -1,7 +1,11 @@ -{/doc/acs-service-contract {ACS Service Contracts}} {ACS Service Contract Documentation} +{/doc/acs-service-contract/ {ACS Service Contracts}} {ACS Service Contract Documentation} ACS Service Contract Documentation +

ACS Service Contract Documentation

Why

To facilitate greater code reuse, application integration, and @@ -36,8 +40,8 @@ containers for operations.

  • operation - a method of an interface. defines a method signature, including both input and outputs as well as metadata such as caching.
  • implementation - an implementation is a set of concrete -functions that fufills an interface.
  • implementation alias - is the method of an implementation that -fufills a given operation of the contract.
  • bindings - association between an interface and an +functions that fulfillss an interface.
  • implementation alias - is the method of an implementation that +fulfillss a given operation of the contract.
  • bindings - association between an interface and an implementation.
  • types - define the kind of input and outputs a operation receives.
  • @@ -57,8 +61,8 @@

    FAQ

    Why Does an implementation reference an interface?

    This might seem a little strange since a binding is the official -reference between an implementation and an interface. However it is -quite possible that an implementation for interface might exist +reference between an implementation and an interface. However, it +is quite possible that an implementation for interface might exist prior to the interface being defined, ie the interface defining package is not installed. By retaining this information the interface defining package can be installed and the implementations @@ -74,16 +78,14 @@

    Creating Interfaces

    creates a new contract to serve as a logical container for operations. contract_desc is a text description of the contract.