Athena Developer Guide

More documents

Recommendations

Info

$' \^' I$

<strong>Athena</strong> Chapter 14 Tools and ToolSvc Version/Issue: 2.0.0 14.3.1 Retrieval of tools via the IToolSvc interface The IToolSvc interface is the ToolSvc specific interface providing methods to retrieve tools. The interface has two retrieve methods that differ in their parameters signature, as shown in Listing 14.4 Listing 14.4 The IToolSvc interface methods 1: virtual StatusCode retrieve(const std::string& type, IAlgTool*& tool, const IInterface* parent=0, bool createIf=true ) = 0; 2: virtual StatusCode retrieve(const std::string& type, const std::string& name, IAlgTool*& tool, const IInterface* parent=0, bool createIf=true ) = 0; The arguments of the method shown in Listing 14.4, line 1, are the tool type (i.e. the class) and the IAlgTool interface of the returned tool. In addition there are two arguments with default values: one is the IInterface of the component requesting the tool, the other a boolean creation flag. If the component requesting a tool passes a pointer to itself as the third argument, it declares to the ToolSvc that it is asking for a “private” instance of the tool. By default a “shared” instance is provided. In general if the requested instance of a Tool does not exist the ToolSvc will create it. This behaviour can be changed by setting to false the last argument of the method. The method shown in Listing 14.4, line 2 differs from the one shown in line 1 by an extra argument, a string specifying the tool dependent part of the full tool name. This enables a component to request two separately configurable instances of the same tool. To help the retrieval of concrete tools two template functions, as shown in Listing 14.5, are provided in the IToolSvc interface file. Listing 14.5 The IToolSvc template methods 1: template 2: StatusCode retrieveTool( const std::string& type, T*& tool, const IInterface* parent=0, bool createIf=true ) {...} 3: template 4: StatusCode retrieveTool( const std::string& type, const std::string& name, T*& tool, const IInterface* parent=0, bool createIf=true ) {...} page 130 The two template methods correspond to the IToolSvc retrieve methods but have the tool returned as a template parameter. Using these methods the component retrieving a tool avoids explicit dynamic-casting to specific additional interfaces or to derived classes.
<strong>Athena</strong> Chapter 14 Tools and ToolSvc Version/Issue: 2.0.0 Listing 14.6 shows an example of retrieval of a shared and of a common tool. Listing 14.6 Example of retrieval of a shared tool in line 8: and of a private tool in line 14: 1: IToolSvc* toolsvc = 0; 2: sc = service( "ToolSvc", toolsvc ); 3: if( sc.isFailure() ) { 4: log
Page 1 and 2:
ATLAS Athena The ATLAS Common Frame
Page 3 and 4:
Athena Table of Contents Version/Is
Page 5 and 6:
Page 7 and 8:
Page 9 and 10:
Athena Chapter 1 Introduction Versi
Page 11 and 12:
Athena Chapter 1 Introduction Versi
Page 13 and 14:
Athena Chapter 2 The framework arch
Page 15 and 16:
Page 17 and 18:
Page 19 and 20:
Athena Chapter 3 Release notes Vers
Page 21 and 22:
Athena Chapter 4 Establishing a dev
Page 23 and 24:
Athena Chapter 5 Writing algorithms
Page 25 and 26:
Page 27 and 28:
Page 29 and 30:
Page 31 and 32:
Page 33 and 34:
Page 35 and 36:
Athena Chapter 6 Scripting Version/
Page 37 and 38:
Page 39 and 40:
Page 41 and 42:
Page 43 and 44:
Athena Chapter 7 Accessing data Ver
Page 45 and 46:
Page 47 and 48:
Page 49 and 50:
Page 51 and 52:
Page 53 and 54:
Page 55 and 56:
Athena Chapter 8 StoreGate - the ev
Page 57 and 58:
Page 59 and 60:
Page 61 and 62:
Page 63 and 64:
Page 65 and 66:
Page 67 and 68:
Page 69 and 70:
Athena Chapter 9 Data dictionary Ve
Page 71 and 72:
Page 73 and 74:
Page 75 and 76:
Athena Chapter 10 Detector Descript
Page 77 and 78:
Athena Chapter 11 Histogram facilit
Page 79 and 80: Athena Chapter 11 Histogram facilit
Page 81 and 82: Athena Chapter 11 Histogram facilit
Page 83 and 84: Athena Chapter 12 N-tuple and Event
Page 95 and 96: Athena Chapter 13 Framework service
Page 123 and 124: Athena Chapter 14 Tools and ToolSvc
Page 129: Athena Chapter 14 Tools and ToolSvc
Page 137 and 138: Athena Chapter 15 Converters Versio
Page 147 and 148: Athena Chapter 16 Visualization Ver
Page 149 and 150: Athena Chapter 17 Physical design i
Page 157 and 158: Athena Chapter 18 Framework package
Page 169 and 170: Athena Chapter 19 Analysis utilitie
Page 171 and 172: Athena Version/Issue: 2.0.0 Appendi
Page 173 and 174: Athena Appendix B Options for stand
Page 181 and 182:
Athena Appendix C Design considerat
Page 183 and 184:
Page 185 and 186:
Page 187 and 188:
Athena Version/Issue: 2.0.0 Appendi
Page 189 and 190:
Athena Version/Issue: 2.0.0 19.6.6
Page 191 and 192:
Athena Version/Issue: 2.0.0 A AIDA
Page 193 and 194:
Athena Version/Issue: 2.0.0 of N-tu
Page 195:
Athena Version/Issue: 2.0.0 ROOT 17
show all

Athena Developer Guide

Create successful ePaper yourself

Delete template?

Save as template?