Difference between revisions of "Uno/Binary/Spec/Cascaded Mapping"

From Apache OpenOffice Wiki
< Uno‎ | Binary
Jump to: navigation, search
(moved from udk.openoffice.org)
 
(Factored out details into Uno/Spec/Cascaded Mapping.)
Line 1: Line 1:
author:  [[User:Kr|Kr]] <br>
 
 
version: {{REVISIONID}} <br>
 
version: {{REVISIONID}} <br>
state:  final         <br>
+
state:  draft         <br>
created: 08/08/2005    <br>
+
 
type:    specification  <br>
 
type:    specification  <br>
  
== Binary UNO ==
+
== Cascaded Mapping ==
=== Cascaded Mapping ===
+
  
 
; Feature
 
; Feature
: This feature extends the mapping search algorithm in a generic way, that it always finds a mapping between any two particular purpose environments, necessarily falling back to the generic UNO environment for mediation in case no specialized mappings can be found.
+
: [[Uno/Spec/Cascaded Mapping | Cascaded Mapping]] for Binary Uno.
: For example:
+
: <code>uno::Mapping("gcc3:thread", "gcc3")</code>
+
: gets mediated via the "uno_uno_thread" purpose bridge:
+
: => Mapping("gcc3:thread" -> "uno:thread" -> "uno" -> "gcc3")
+
  
; Rationale : The introduction of purpose environments allows, to have environments of the same type (e.g. "gcc3") but with different purposes. The introduction of cascaded mappings allows to map between environments of different purposes, by using the UNO runtimes purpose mapping mechanism.
+
; Rationale:  
  
 
; API: None.
 
; API: None.
Line 21: Line 14:
 
; Compatibility Issues: None.
 
; Compatibility Issues: None.
  
; Dependencies : Purpose Environments
+
; Dependencies: [[Uno/Binary/Spec/Purpose Environments]]
 
+
; Changes
+
: The mapping function checks, if any of the passed in environments is a purpose environment. If so, the purpose environment mapping function is called.
+
 
+
: Mapping algorithm:
+
:# directly map, in all cases with the same purpose: "uno:mutex" -> "gcc3:mutex" => "uno:mutex" -gcc3_uno-> "gcc3:mutex"
+
:# mediate through a purpose in case it is asked for a mapping between different purposes: "uno:mutex" -mutex_uno_uno-> "uno", the purpose here is "mutex_uno_uno"
+
:# mediate through the "uno" environment, if asked for a mapping from one purpose environment to another purpose environment: "uno:mutex" -> "uno:thread" => "uno:mutex" -mutex_uno_uno-> "uno" -thread_uno_uno-> "uno:thread"
+
:# recursively apply -4- in case a multi purpose has been specified: "gcc3:mutex:debug" -> "gcc3:thread" => "gcc3:mutex:debug" -gcc3_uno-> "uno:mutex:debug" -debug_uno_uno-> "uno:mutex" -mutex_uno_uno-> "uno" -thread_uno_uno-> "uno:thread" -gcc3_uno-> "gcc3:thread"
+
:# map through the nearest "uno:<purpose>" environment: "gcc3:debug:mutex" <-> "gcc3:debug:thread" => "gcc3:debug:mutex" -gcc3_uno-> "uno:debug:mutex" -mutex_uno_uno-> "uno:debug" -thread_uno_uno-> "uno:debug:thread" -gcc3_uno-> "gcc3:debug:thread"
+
:# shortcut if possible, no is mediation necessary, should directly map through purpose: "uno:debug:thread" -> "uno:debug" => "uno:debug:thread" -thread_uno_uno-> "uno:debug"
+
: The mapping algorithm does not know any particular purpose. It is just leverages the current purpose API.
+

Revision as of 08:50, 18 April 2006

version: 8166
state: draft
type: specification

Cascaded Mapping

Feature
Cascaded Mapping for Binary Uno.
Rationale
API
None.
Compatibility Issues
None.
Dependencies
Uno/Binary/Spec/Purpose Environments
Personal tools