3 * Copyright (c) 2002 - 2007, Blue Static <http://www.bluestatic.org>
5 * This program is free software; you can redistribute it and/or modify it under the terms of the GNU
6 * General Public License as published by the Free Software Foundation; either version 2 of the
7 * License, or (at your option) any later version.
9 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
10 * even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * General Public License for more details.
13 * You should have received a copy of the GNU General Public License along with this program; if not,
14 * write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
17 #import "DebuggerConnection.h"
18 #import "AppDelegate.h"
20 @interface DebuggerConnection (Private
)
22 - (NSString
*)createCommand
: (NSString
*)cmd
;
26 @implementation DebuggerConnection
29 * Creates a new DebuggerConnection and initializes the socket from the given connection
32 - (id)initWithPort
: (int)port session
: (NSString
*)session
34 if (self = [super init
])
37 _session
= [session retain
];
40 _windowController
= [[DebuggerWindowController alloc
] initWithConnection
: self];
41 [[_windowController window
] makeKeyAndOrderFront
: self];
43 // now that we have our host information, open the socket
44 _socket
= [[SocketWrapper alloc
] initWithPort
: port
];
45 [_socket setDelegate
: self];
46 [_windowController setStatus
: @
"Connecting"];
53 * This is a forwarded message from DebuggerWindowController that tells the connection to prepare to
56 - (void)windowDidClose
58 [[NSApp delegate
] unregisterConnection
: self];
62 * Releases all of the object's data members and closes the streams
68 [_windowController release
];
74 * Gets the port number
82 * Gets the session name
90 * Returns the name of the remote host
92 - (NSString
*)remoteHost
96 return @
"(DISCONNECTED)";
98 return [_socket remoteHost
];
102 * Returns whether or not we have an active connection
110 * SocketWrapper delegate method that is called whenever new data is received
112 - (void)dataReceived
: (NSData
*)response deliverTo
: (SEL)selector
114 NSXMLDocument
*doc
= [[NSXMLDocument alloc
] initWithData
: response options
: NSXMLDocumentTidyXML error
: nil];
116 // check and see if there's an error
117 NSArray
*error
= [[doc rootElement
] elementsForName
: @
"error"];
118 if ([error count
] > 0)
120 [_windowController setError
: [[[[error objectAtIndex
: 0] children
] objectAtIndex
: 0] stringValue
]];
124 // if the caller of [_socket receive:] specified a deliverTo, just forward the message to them
127 [self performSelector
: selector withObject
: doc
];
134 * SocketWrapper delegate method that is called after data is sent. This really
135 * isn't useful for much.
137 - (void)dataSent
: (NSString
*)data
139 NSLog(@
"send = %@", data
);
143 * Called by SocketWrapper after the connection is successful. This immediately calls
144 * -[SocketWrapper receive] to clear the way for communication
146 - (void)socketDidAccept
149 [_socket receive
: @selector(handshake
:)];
153 * Receives errors from the SocketWrapper and updates the display
155 - (void)errorEncountered
: (NSError
*)error
157 [_windowController setError
: [error domain
]];
161 * The initial packet handshake. This allows us to set things like the title of the window
162 * and glean information about hte server we are debugging
164 - (void)handshake
: (NSXMLDocument
*)doc
166 [self refreshStatus
];
170 * Handler used by dataReceived:deliverTo: for anytime the status command is issued. It sets
171 * the window controller's status text
173 - (void)updateStatus
: (NSXMLDocument
*)doc
175 [_windowController setStatus
: [[[[doc rootElement
] attributeForName
: @
"status"] stringValue
] capitalizedString
]];
179 * Tells the debugger to continue running the script
183 [_socket send
: [self createCommand
: @
"run"]];
184 [self refreshStatus
];
188 * Method that runs tells the debugger to give us its status. This will call _updateStatus
189 * and will update the status text on the window
191 - (void)refreshStatus
193 [_socket send
: [self createCommand
: @
"status"]];
194 [_socket receive
: @selector(updateStatus
:)];
198 * Tells the debugger to step into the current command.
202 [_socket send
: [self createCommand
: @
"step_into"]];
203 [_socket receive
: nil];
204 [self refreshStatus
];
205 [self updateStackTraceAndRegisters
];
209 * Tells the debugger to step out of the current context
213 [_socket send
: [self createCommand
: @
"step_out"]];
214 [_socket receive
: nil];
215 [self refreshStatus
];
216 [self updateStackTraceAndRegisters
];
220 * Tells the debugger to step over the current function
224 [_socket send
: [self createCommand
: @
"step_over"]];
225 [_socket receive
: nil];
226 [self refreshStatus
];
227 [self updateStackTraceAndRegisters
];
231 * This function queries the debug server for the current stacktrace and all the registers on
232 * level one. If a user then tries to expand past level one... TOOD: HOLY CRAP WHAT DO WE DO PAST LEVEL 1?
234 - (void)updateStackTraceAndRegisters
236 [_socket send
: [self createCommand
: @
"stack_get"]];
237 [_socket receive
: @selector(stackReceived
:)];
239 [_socket send
: [self createCommand
: @
"context_get"]];
240 [_socket receive
: @selector(registerReceived
:)];
244 * Called by the dataReceived delivery delegate. This updates the window controller's data
245 * for the stack trace
247 - (void)stackReceived
: (NSXMLDocument
*)doc
249 NSArray
*children
= [[doc rootElement
] children
];
250 NSMutableArray
*stack
= [NSMutableArray array
];
251 NSMutableDictionary
*dict
= [NSMutableDictionary dictionary
];
252 for (int i
= 0; i
< [children count
]; i
++)
254 NSArray
*attrs
= [[children objectAtIndex
: i
] attributes
];
255 for (int j
= 0; j
< [attrs count
]; j
++)
257 [dict setValue
: [[attrs objectAtIndex
: j
] stringValue
] forKey
: [[attrs objectAtIndex
: j
] name
]];
259 [stack addObject
: dict
];
260 dict
= [NSMutableDictionary dictionary
];
262 [_windowController setStack
: stack
];
266 * Called when we have a new register to display
268 - (void)registerReceived
: (NSXMLDocument
*)doc
270 [_windowController setRegister
: doc
];
274 * Tells the debugger engine to get a specifc property. This also takes in the NSXMLElement
275 * that requested it so that the child can be attached in the delivery.
277 - (void)getProperty
: (NSString
*)property forElement
: (NSXMLElement
*)elm
279 [_socket send
: [self createCommand
: [NSString stringWithFormat
: @
"property_get -n \"%@\"", property
]]];
280 _depthFetchElement
= elm
;
281 [_socket receive
: @selector(propertyReceived
:)];
285 * Called when a property is received. This then adds the result as children to the passed object
287 - (void)propertyReceived
: (NSXMLDocument
*)doc
291 <property> <!-- this is the one we requested -->
292 <property ... /> <!-- these are what we want -->
297 // we now have to detach all the children so we can insert them into another document
298 NSXMLElement
*parent
= (NSXMLElement
*)[[doc rootElement
] childAtIndex
: 0];
299 NSArray
*children
= [parent children
];
300 [parent setChildren
: nil];
301 [_windowController addChildren
: children toNode
: _depthFetchElement
];
302 _depthFetchElement
= nil;
306 * Helper method to create a string command with the -i <session> automatically tacked on
308 - (NSString
*)createCommand
: (NSString
*)cmd
310 return [NSString stringWithFormat
: @
"%@ -i %@", cmd
, _session
];