aosp12/system/tools/aidl/parser.h

127 lines
3.9 KiB
C++

/*
* Copyright (C) 2019, The Android Open Source Project
*
* 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
*
* http://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.
*/
#pragma once
#include "aidl_language.h"
#include "aidl_typenames.h"
#include "comments.h"
#include "io_delegate.h"
#include "logging.h"
#include "options.h"
#include <memory>
#include <string>
#include <vector>
struct yy_buffer_state;
typedef yy_buffer_state* YY_BUFFER_STATE;
class AidlToken {
public:
AidlToken(const std::string& text, android::aidl::Comments comments)
: text_(text), comments_(std::move(comments)) {}
~AidlToken() = default;
AidlToken(const AidlToken&) = delete;
AidlToken(AidlToken&&) = delete;
AidlToken& operator=(const AidlToken&) = delete;
AidlToken& operator=(AidlToken&&) = delete;
const std::string& GetText() const { return text_; }
const android::aidl::Comments& GetComments() const { return comments_; }
template <typename T>
void Append(T&& text) {
text_ += std::forward<T>(text);
}
private:
std::string text_;
android::aidl::Comments comments_;
};
using TypeResolver = std::function<bool(const AidlDocument*, AidlTypeSpecifier*)>;
class Parser {
public:
// non-copyable, non-assignable
Parser(const Parser&) = delete;
Parser& operator=(const Parser&) = delete;
~Parser();
// Parse contents of file |filename|. Should only be called once.
static std::unique_ptr<Parser> Parse(const std::string& filename,
const android::aidl::IoDelegate& io_delegate,
AidlTypenames& typenames);
void AddError() { error_++; }
bool HasError() const { return error_ != 0; }
const std::string& FileName() const { return filename_; }
void* Scanner() const { return scanner_; }
// This restricts the grammar to something more reasonable. One alternative
// would be to support multiple sets of type specifiers in our AST, but then a
// lot of later code would have to deal with this more complicated type. So,
// in order to keep the AST simpler, restricting the grammar here.
//
// Takes ownership of type_args, modifies type.
void SetTypeParameters(AidlTypeSpecifier* type,
std::vector<std::unique_ptr<AidlTypeSpecifier>>* type_args);
void SetPackage(const std::string& package) { package_ = package; }
const std::string& Package() const { return package_; }
void DeferResolution(AidlTypeSpecifier* typespec) {
unresolved_typespecs_.emplace_back(typespec);
}
const vector<AidlTypeSpecifier*>& GetUnresolvedTypespecs() const { return unresolved_typespecs_; }
bool Resolve(TypeResolver& type_resolver);
void SetDocument(std::unique_ptr<AidlDocument>&& document) {
// The parsed document is owned by typenames_. This parser object only has
// a reference to it.
document_ = document.get();
if (!typenames_.AddDocument(std::move(document))) {
document_ = nullptr;
AddError();
}
}
const AidlDocument& ParsedDocument() const {
AIDL_FATAL_IF(HasError(), FileName());
return *document_;
}
private:
explicit Parser(const std::string& filename, std::string& raw_buffer,
android::aidl::AidlTypenames& typenames);
std::string filename_;
std::string package_;
AidlTypenames& typenames_;
void* scanner_ = nullptr;
YY_BUFFER_STATE buffer_;
int error_ = 0;
vector<AidlTypeSpecifier*> unresolved_typespecs_;
const AidlDocument* document_;
};