Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2019, The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | #pragma once |
| 18 | |
| 19 | #include "aidl_language.h" |
| 20 | #include "aidl_typenames.h" |
Jooyung Han | 8451a20 | 2021-01-16 03:07:06 +0900 | [diff] [blame] | 21 | #include "comments.h" |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 22 | #include "io_delegate.h" |
Steven Moreland | 2178081 | 2020-09-11 01:29:45 +0000 | [diff] [blame] | 23 | #include "logging.h" |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 24 | #include "options.h" |
| 25 | |
| 26 | #include <memory> |
| 27 | #include <string> |
| 28 | #include <vector> |
| 29 | |
| 30 | struct yy_buffer_state; |
| 31 | typedef yy_buffer_state* YY_BUFFER_STATE; |
| 32 | |
Jiyong Park | 187bcc9 | 2020-07-22 18:40:30 +0900 | [diff] [blame] | 33 | class AidlToken { |
| 34 | public: |
Jooyung Han | 8451a20 | 2021-01-16 03:07:06 +0900 | [diff] [blame] | 35 | AidlToken(const std::string& text, android::aidl::Comments comments) |
| 36 | : text_(text), comments_(std::move(comments)) {} |
Jiyong Park | 187bcc9 | 2020-07-22 18:40:30 +0900 | [diff] [blame] | 37 | ~AidlToken() = default; |
| 38 | |
| 39 | AidlToken(const AidlToken&) = delete; |
| 40 | AidlToken(AidlToken&&) = delete; |
| 41 | AidlToken& operator=(const AidlToken&) = delete; |
| 42 | AidlToken& operator=(AidlToken&&) = delete; |
| 43 | |
| 44 | const std::string& GetText() const { return text_; } |
Jooyung Han | 8451a20 | 2021-01-16 03:07:06 +0900 | [diff] [blame] | 45 | const android::aidl::Comments& GetComments() const { return comments_; } |
Jiyong Park | 187bcc9 | 2020-07-22 18:40:30 +0900 | [diff] [blame] | 46 | |
Jooyung Han | 9bcf80e | 2020-10-05 16:25:34 +0900 | [diff] [blame] | 47 | template <typename T> |
| 48 | void Append(T&& text) { |
| 49 | text_ += std::forward<T>(text); |
| 50 | } |
| 51 | |
Jiyong Park | 187bcc9 | 2020-07-22 18:40:30 +0900 | [diff] [blame] | 52 | private: |
| 53 | std::string text_; |
Jooyung Han | 8451a20 | 2021-01-16 03:07:06 +0900 | [diff] [blame] | 54 | android::aidl::Comments comments_; |
Jiyong Park | 187bcc9 | 2020-07-22 18:40:30 +0900 | [diff] [blame] | 55 | }; |
| 56 | |
Jooyung Han | ce6733e | 2021-05-22 02:44:17 +0900 | [diff] [blame] | 57 | using TypeResolver = std::function<bool(const AidlDefinedType*, AidlTypeSpecifier*)>; |
| 58 | bool ResolveReferences(const AidlDocument& document, TypeResolver& resolver); |
Jooyung Han | 2981384 | 2020-12-08 01:28:03 +0900 | [diff] [blame] | 59 | |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 60 | class Parser { |
| 61 | public: |
| 62 | // non-copyable, non-assignable |
| 63 | Parser(const Parser&) = delete; |
| 64 | Parser& operator=(const Parser&) = delete; |
| 65 | |
| 66 | ~Parser(); |
| 67 | |
| 68 | // Parse contents of file |filename|. Should only be called once. |
Jooyung Han | ce6733e | 2021-05-22 02:44:17 +0900 | [diff] [blame] | 69 | static const AidlDocument* Parse(const std::string& filename, |
| 70 | const android::aidl::IoDelegate& io_delegate, |
Jooyung Han | 93f48f0 | 2021-06-05 00:11:16 +0900 | [diff] [blame] | 71 | AidlTypenames& typenames, bool is_preprocessed = false); |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 72 | |
| 73 | void AddError() { error_++; } |
Jiyong Park | 8e79b7f | 2020-07-20 20:52:38 +0900 | [diff] [blame] | 74 | bool HasError() const { return error_ != 0; } |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 75 | |
| 76 | const std::string& FileName() const { return filename_; } |
| 77 | void* Scanner() const { return scanner_; } |
| 78 | |
Steven Moreland | 6c07b83 | 2020-10-29 23:39:53 +0000 | [diff] [blame] | 79 | // This restricts the grammar to something more reasonable. One alternative |
| 80 | // would be to support multiple sets of type specifiers in our AST, but then a |
| 81 | // lot of later code would have to deal with this more complicated type. So, |
| 82 | // in order to keep the AST simpler, restricting the grammar here. |
| 83 | // |
| 84 | // Takes ownership of type_args, modifies type. |
| 85 | void SetTypeParameters(AidlTypeSpecifier* type, |
| 86 | std::vector<std::unique_ptr<AidlTypeSpecifier>>* type_args); |
| 87 | |
Jooyung Han | 93f48f0 | 2021-06-05 00:11:16 +0900 | [diff] [blame] | 88 | // fully-qualified type names are allowed only in preprocessed files |
| 89 | void CheckValidTypeName(const AidlToken& token, const AidlLocation& loc); |
| 90 | |
Steven Moreland | 85762bf | 2021-10-08 15:04:22 -0700 | [diff] [blame] | 91 | void SetPackage(const std::string& package); |
Jiyong Park | 1813218 | 2020-06-08 20:24:40 +0900 | [diff] [blame] | 92 | const std::string& Package() const { return package_; } |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 93 | |
Jooyung Han | 3578498 | 2021-06-29 06:26:12 +0900 | [diff] [blame] | 94 | void MakeDocument(const AidlLocation& location, const Comments& comments, |
Jooyung Han | f08c15f | 2022-01-28 14:57:13 +0900 | [diff] [blame] | 95 | std::vector<std::string> imports, |
Jooyung Han | 3578498 | 2021-06-29 06:26:12 +0900 | [diff] [blame] | 96 | std::vector<std::unique_ptr<AidlDefinedType>> defined_types); |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 97 | |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 98 | private: |
Jooyung Han | 93f48f0 | 2021-06-05 00:11:16 +0900 | [diff] [blame] | 99 | explicit Parser(const std::string& filename, std::string& raw_buffer, bool is_preprocessed); |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 100 | |
| 101 | std::string filename_; |
Jooyung Han | 93f48f0 | 2021-06-05 00:11:16 +0900 | [diff] [blame] | 102 | bool is_preprocessed_; |
Jiyong Park | 1813218 | 2020-06-08 20:24:40 +0900 | [diff] [blame] | 103 | std::string package_; |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 104 | void* scanner_ = nullptr; |
| 105 | YY_BUFFER_STATE buffer_; |
| 106 | int error_ = 0; |
| 107 | |
Jooyung Han | 93f48f0 | 2021-06-05 00:11:16 +0900 | [diff] [blame] | 108 | std::unique_ptr<AidlDocument> document_; |
Jiyong Park | e5c4529 | 2020-05-26 19:06:24 +0900 | [diff] [blame] | 109 | }; |