6a25ee09f5
* go.mod: update google/go-dap to 0.5.0 * Go mod tidy Co-authored-by: Polina Sokolova <polinasok@users.noreply.github.com>
230 lines
11 KiB
Go
230 lines
11 KiB
Go
// Copyright 2020 Google LLC
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// https://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
// This file contains utilities for decoding JSON-encoded bytes into DAP message.
|
|
|
|
package dap
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
)
|
|
|
|
// DecodeProtocolMessageFieldError describes which JSON attribute
|
|
// has an unsupported value that the decoding cannot handle.
|
|
type DecodeProtocolMessageFieldError struct {
|
|
Seq int
|
|
SubType string
|
|
FieldName string
|
|
FieldValue string
|
|
}
|
|
|
|
func (e *DecodeProtocolMessageFieldError) Error() string {
|
|
return fmt.Sprintf("%s %s '%s' is not supported (seq: %d)", e.SubType, e.FieldName, e.FieldValue, e.Seq)
|
|
}
|
|
|
|
// DecodeProtocolMessage parses the JSON-encoded data and returns the result of
|
|
// the appropriate type within the ProtocolMessage hierarchy. If message type,
|
|
// command, etc cannot be cast, returns DecodeProtocolMessageFieldError.
|
|
// See also godoc for json.Unmarshal, which is used for underlying decoding.
|
|
func DecodeProtocolMessage(data []byte) (Message, error) {
|
|
var protomsg ProtocolMessage
|
|
if err := json.Unmarshal(data, &protomsg); err != nil {
|
|
return nil, err
|
|
}
|
|
switch protomsg.Type {
|
|
case "request":
|
|
return decodeRequest(data)
|
|
case "response":
|
|
return decodeResponse(data)
|
|
case "event":
|
|
return decodeEvent(data)
|
|
default:
|
|
return nil, &DecodeProtocolMessageFieldError{protomsg.GetSeq(), "ProtocolMessage", "type", protomsg.Type}
|
|
}
|
|
}
|
|
|
|
type messageCtor func() Message
|
|
|
|
// decodeRequest determines what request type in the ProtocolMessage hierarchy
|
|
// data corresponds to and uses json.Unmarshal to populate the corresponding
|
|
// struct to be returned.
|
|
func decodeRequest(data []byte) (Message, error) {
|
|
var r Request
|
|
if err := json.Unmarshal(data, &r); err != nil {
|
|
return nil, err
|
|
}
|
|
if ctor, ok := requestCtor[r.Command]; ok {
|
|
requestPtr := ctor()
|
|
err := json.Unmarshal(data, requestPtr)
|
|
return requestPtr, err
|
|
}
|
|
return nil, &DecodeProtocolMessageFieldError{r.GetSeq(), "Request", "command", r.Command}
|
|
}
|
|
|
|
// Mapping of request commands and corresponding struct constructors that
|
|
// can be passed to json.Unmarshal.
|
|
var requestCtor = map[string]messageCtor{
|
|
"cancel": func() Message { return &CancelRequest{} },
|
|
"runInTerminal": func() Message { return &RunInTerminalRequest{} },
|
|
"initialize": func() Message {
|
|
return &InitializeRequest{
|
|
Arguments: InitializeRequestArguments{
|
|
// Set the default values specified here: https://microsoft.github.io/debug-adapter-protocol/specification#Requests_Initialize.
|
|
LinesStartAt1: true,
|
|
ColumnsStartAt1: true,
|
|
PathFormat: "path",
|
|
},
|
|
}
|
|
},
|
|
"configurationDone": func() Message { return &ConfigurationDoneRequest{} },
|
|
"launch": func() Message { return &LaunchRequest{} },
|
|
"attach": func() Message { return &AttachRequest{} },
|
|
"restart": func() Message { return &RestartRequest{} },
|
|
"disconnect": func() Message { return &DisconnectRequest{} },
|
|
"terminate": func() Message { return &TerminateRequest{} },
|
|
"breakpointLocations": func() Message { return &BreakpointLocationsRequest{} },
|
|
"setBreakpoints": func() Message { return &SetBreakpointsRequest{} },
|
|
"setFunctionBreakpoints": func() Message { return &SetFunctionBreakpointsRequest{} },
|
|
"setExceptionBreakpoints": func() Message { return &SetExceptionBreakpointsRequest{} },
|
|
"dataBreakpointInfo": func() Message { return &DataBreakpointInfoRequest{} },
|
|
"setDataBreakpoints": func() Message { return &SetDataBreakpointsRequest{} },
|
|
"continue": func() Message { return &ContinueRequest{} },
|
|
"next": func() Message { return &NextRequest{} },
|
|
"stepIn": func() Message { return &StepInRequest{} },
|
|
"stepOut": func() Message { return &StepOutRequest{} },
|
|
"stepBack": func() Message { return &StepBackRequest{} },
|
|
"reverseContinue": func() Message { return &ReverseContinueRequest{} },
|
|
"restartFrame": func() Message { return &RestartFrameRequest{} },
|
|
"goto": func() Message { return &GotoRequest{} },
|
|
"pause": func() Message { return &PauseRequest{} },
|
|
"stackTrace": func() Message { return &StackTraceRequest{} },
|
|
"scopes": func() Message { return &ScopesRequest{} },
|
|
"variables": func() Message { return &VariablesRequest{} },
|
|
"setVariable": func() Message { return &SetVariableRequest{} },
|
|
"source": func() Message { return &SourceRequest{} },
|
|
"threads": func() Message { return &ThreadsRequest{} },
|
|
"terminateThreads": func() Message { return &TerminateThreadsRequest{} },
|
|
"modules": func() Message { return &ModulesRequest{} },
|
|
"loadedSources": func() Message { return &LoadedSourcesRequest{} },
|
|
"evaluate": func() Message { return &EvaluateRequest{} },
|
|
"setExpression": func() Message { return &SetExpressionRequest{} },
|
|
"stepInTargets": func() Message { return &StepInTargetsRequest{} },
|
|
"gotoTargets": func() Message { return &GotoTargetsRequest{} },
|
|
"completions": func() Message { return &CompletionsRequest{} },
|
|
"exceptionInfo": func() Message { return &ExceptionInfoRequest{} },
|
|
"readMemory": func() Message { return &ReadMemoryRequest{} },
|
|
"disassemble": func() Message { return &DisassembleRequest{} },
|
|
}
|
|
|
|
// decodeResponse determines what response type in the ProtocolMessage hierarchy
|
|
// data corresponds to and uses json.Unmarshal to populate the corresponding
|
|
// struct to be returned.
|
|
func decodeResponse(data []byte) (Message, error) {
|
|
var r Response
|
|
if err := json.Unmarshal(data, &r); err != nil {
|
|
return nil, err
|
|
}
|
|
if !r.Success {
|
|
var er ErrorResponse
|
|
err := json.Unmarshal(data, &er)
|
|
return &er, err
|
|
}
|
|
if ctor, ok := responseCtor[r.Command]; ok {
|
|
responsePtr := ctor()
|
|
err := json.Unmarshal(data, responsePtr)
|
|
return responsePtr, err
|
|
}
|
|
return nil, &DecodeProtocolMessageFieldError{r.GetSeq(), "Response", "command", r.Command}
|
|
}
|
|
|
|
// Mapping of response commands and corresponding struct constructors that
|
|
// can be passed to json.Unmarshal.
|
|
var responseCtor = map[string]messageCtor{
|
|
"cancel": func() Message { return &CancelResponse{} },
|
|
"runInTerminal": func() Message { return &RunInTerminalResponse{} },
|
|
"initialize": func() Message { return &InitializeResponse{} },
|
|
"configurationDone": func() Message { return &ConfigurationDoneResponse{} },
|
|
"launch": func() Message { return &LaunchResponse{} },
|
|
"attach": func() Message { return &AttachResponse{} },
|
|
"restart": func() Message { return &RestartResponse{} },
|
|
"disconnect": func() Message { return &DisconnectResponse{} },
|
|
"terminate": func() Message { return &TerminateResponse{} },
|
|
"breakpointLocations": func() Message { return &BreakpointLocationsResponse{} },
|
|
"setBreakpoints": func() Message { return &SetBreakpointsResponse{} },
|
|
"setFunctionBreakpoints": func() Message { return &SetFunctionBreakpointsResponse{} },
|
|
"setExceptionBreakpoints": func() Message { return &SetExceptionBreakpointsResponse{} },
|
|
"dataBreakpointInfo": func() Message { return &DataBreakpointInfoResponse{} },
|
|
"setDataBreakpoints": func() Message { return &SetDataBreakpointsResponse{} },
|
|
"continue": func() Message { return &ContinueResponse{} },
|
|
"next": func() Message { return &NextResponse{} },
|
|
"stepIn": func() Message { return &StepInResponse{} },
|
|
"stepOut": func() Message { return &StepOutResponse{} },
|
|
"stepBack": func() Message { return &StepBackResponse{} },
|
|
"reverseContinue": func() Message { return &ReverseContinueResponse{} },
|
|
"restartFrame": func() Message { return &RestartFrameResponse{} },
|
|
"goto": func() Message { return &GotoResponse{} },
|
|
"pause": func() Message { return &PauseResponse{} },
|
|
"stackTrace": func() Message { return &StackTraceResponse{} },
|
|
"scopes": func() Message { return &ScopesResponse{} },
|
|
"variables": func() Message { return &VariablesResponse{} },
|
|
"setVariable": func() Message { return &SetVariableResponse{} },
|
|
"source": func() Message { return &SourceResponse{} },
|
|
"threads": func() Message { return &ThreadsResponse{} },
|
|
"terminateThreads": func() Message { return &TerminateThreadsResponse{} },
|
|
"modules": func() Message { return &ModulesResponse{} },
|
|
"loadedSources": func() Message { return &LoadedSourcesResponse{} },
|
|
"evaluate": func() Message { return &EvaluateResponse{} },
|
|
"setExpression": func() Message { return &SetExpressionResponse{} },
|
|
"stepInTargets": func() Message { return &StepInTargetsResponse{} },
|
|
"gotoTargets": func() Message { return &GotoTargetsResponse{} },
|
|
"completions": func() Message { return &CompletionsResponse{} },
|
|
"exceptionInfo": func() Message { return &ExceptionInfoResponse{} },
|
|
"readMemory": func() Message { return &ReadMemoryResponse{} },
|
|
"disassemble": func() Message { return &DisassembleResponse{} },
|
|
}
|
|
|
|
// decodeEvent determines what event type in the ProtocolMessage hierarchy
|
|
// data corresponds to and uses json.Unmarshal to populate the corresponding
|
|
// struct to be returned.
|
|
func decodeEvent(data []byte) (Message, error) {
|
|
var e Event
|
|
if err := json.Unmarshal(data, &e); err != nil {
|
|
return nil, err
|
|
}
|
|
if ctor, ok := eventCtor[e.Event]; ok {
|
|
eventPtr := ctor()
|
|
err := json.Unmarshal(data, eventPtr)
|
|
return eventPtr, err
|
|
}
|
|
return nil, &DecodeProtocolMessageFieldError{e.GetSeq(), "Event", "event", e.Event}
|
|
}
|
|
|
|
// Mapping of event ids and corresponding struct constructors that
|
|
// can be passed to json.Unmarshal.
|
|
var eventCtor = map[string]messageCtor{
|
|
"initialized": func() Message { return &InitializedEvent{} },
|
|
"stopped": func() Message { return &StoppedEvent{} },
|
|
"continued": func() Message { return &ContinuedEvent{} },
|
|
"exited": func() Message { return &ExitedEvent{} },
|
|
"terminated": func() Message { return &TerminatedEvent{} },
|
|
"thread": func() Message { return &ThreadEvent{} },
|
|
"output": func() Message { return &OutputEvent{} },
|
|
"breakpoint": func() Message { return &BreakpointEvent{} },
|
|
"module": func() Message { return &ModuleEvent{} },
|
|
"loadedSource": func() Message { return &LoadedSourceEvent{} },
|
|
"process": func() Message { return &ProcessEvent{} },
|
|
"capabilities": func() Message { return &CapabilitiesEvent{} },
|
|
}
|