blob: a4f7ef923457fc5401e718fbe423ff01fedffdc2 [file] [log] [blame]
Andreas Huber1aec3972016-08-26 09:26:32 -07001/*
2 * Copyright (C) 2016 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
Andreas Huberc9410c72016-07-28 12:18:40 -070017#include "AST.h"
18
Andreas Huber5345ec22016-07-29 13:33:27 -070019#include "Coordinator.h"
Yifan Hongf24fa852016-09-23 11:03:15 -070020#include "EnumType.h"
Timur Iskhakov33431e62017-08-21 17:31:23 -070021#include "FmqType.h"
Andreas Hubereb1081f2016-07-28 13:13:24 -070022#include "HandleType.h"
Andreas Huberbfd76212016-08-09 11:12:16 -070023#include "Interface.h"
Yifan Honga4b53d02016-10-31 17:29:10 -070024#include "Location.h"
Neel Mehta0ee353f2019-05-30 17:40:29 -070025#include "Method.h"
Andreas Huberc9410c72016-07-28 12:18:40 -070026#include "Scope.h"
Andreas Huber8d3ac0c2016-08-04 14:49:23 -070027#include "TypeDef.h"
Andreas Huberc9410c72016-07-28 12:18:40 -070028
Andreas Hubereb1081f2016-07-28 13:13:24 -070029#include <android-base/logging.h>
Timur Iskhakovcb0ba522017-07-17 20:01:37 -070030#include <hidl-util/FQName.h>
31#include <hidl-util/Formatter.h>
32#include <hidl-util/StringHelper.h>
Andreas Huberc9410c72016-07-28 12:18:40 -070033#include <stdlib.h>
Neel Mehta0ee353f2019-05-30 17:40:29 -070034
Timur Iskhakovcb0ba522017-07-17 20:01:37 -070035#include <algorithm>
36#include <iostream>
Neel Mehta0ee353f2019-05-30 17:40:29 -070037#include <map>
38#include <string>
Andreas Huberc9410c72016-07-28 12:18:40 -070039
Andreas Huberc9410c72016-07-28 12:18:40 -070040namespace android {
41
Steven Moreland04dea8d2018-02-06 13:11:24 -080042AST::AST(const Coordinator* coordinator, const Hash* fileHash)
Andreas Huber5345ec22016-07-29 13:33:27 -070043 : mCoordinator(coordinator),
Steven Moreland04dea8d2018-02-06 13:11:24 -080044 mFileHash(fileHash),
Neel Mehtaf6293d32019-06-12 17:16:38 -070045 mRootScope("(root scope)", FQName(),
46 Location::startOf(coordinator->makeRelative(fileHash->getPath())),
Steven Moreland04dea8d2018-02-06 13:11:24 -080047 nullptr /* parent */) {}
Andreas Huberc9410c72016-07-28 12:18:40 -070048
Neel Mehta693169b2019-05-29 18:45:25 -070049Scope* AST::getMutableRootScope() {
Timur Iskhakovcb0ba522017-07-17 20:01:37 -070050 return &mRootScope;
Andreas Huberc9410c72016-07-28 12:18:40 -070051}
52
Neel Mehta693169b2019-05-29 18:45:25 -070053const Scope& AST::getRootScope() const {
54 return mRootScope;
55}
56
Yifan Hongbe627b32016-10-28 18:38:56 -070057// used by the parser.
58void AST::addSyntaxError() {
59 mSyntaxErrors++;
60}
61
62size_t AST::syntaxErrors() const {
63 return mSyntaxErrors;
64}
65
Steven Moreland04dea8d2018-02-06 13:11:24 -080066const std::string& AST::getFilename() const {
67 return mFileHash->getPath();
68}
69const Hash* AST::getFileHash() const {
70 return mFileHash;
Andreas Huber0d0f9a22016-08-17 10:26:11 -070071}
72
Neel Mehtaf6293d32019-06-12 17:16:38 -070073const Coordinator& AST::getCoordinator() const {
74 return *mCoordinator;
75}
76
Andreas Huber84f89de2016-07-28 15:39:51 -070077bool AST::setPackage(const char *package) {
Steven Morelande1b157e2018-03-06 14:18:32 -080078 if (!mPackage.setTo(package)) {
79 return false;
80 }
Andreas Huber84f89de2016-07-28 15:39:51 -070081
Andreas Huberda51b8e2016-07-28 16:00:57 -070082 if (mPackage.package().empty()
83 || mPackage.version().empty()
84 || !mPackage.name().empty()) {
Andreas Huber84f89de2016-07-28 15:39:51 -070085 return false;
86 }
87
Andreas Huber84f89de2016-07-28 15:39:51 -070088 return true;
Andreas Hubereb1081f2016-07-28 13:13:24 -070089}
90
Andreas Hubera2723d22016-07-29 15:36:07 -070091FQName AST::package() const {
92 return mPackage;
93}
94
Steven Moreland19f11b52017-05-12 18:22:21 -070095bool AST::isInterface() const {
Timur Iskhakovcb0ba522017-07-17 20:01:37 -070096 return mRootScope.getInterface() != nullptr;
Andreas Hubera2723d22016-07-29 15:36:07 -070097}
98
Steven Morelandb47a2622018-07-11 09:04:25 -070099bool AST::definesInterfaces() const {
100 return mRootScope.definesInterfaces();
Andreas Huber7c5ddfb2016-09-29 13:45:22 -0700101}
102
Timur Iskhakov33431e62017-08-21 17:31:23 -0700103status_t AST::postParse() {
Timur Iskhakov77dd65c2017-08-31 22:46:56 -0700104 status_t err;
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700105
Yifan Hong0e192c42018-10-23 15:32:19 -0700106 // lookupTypes is the first pass for references to be resolved.
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700107 err = lookupTypes();
108 if (err != OK) return err;
Yifan Hong0e192c42018-10-23 15:32:19 -0700109
110 // Indicate that all types are now in "postParse" stage.
111 err = setParseStage(Type::ParseStage::PARSE, Type::ParseStage::POST_PARSE);
112 if (err != OK) return err;
113
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700114 // validateDefinedTypesUniqueNames is the first call
115 // after lookup, as other errors could appear because
116 // user meant different type than we assumed.
Timur Iskhakov565b0132017-09-06 18:07:11 -0700117 err = validateDefinedTypesUniqueNames();
118 if (err != OK) return err;
Timur Iskhakov458ca362017-09-12 23:16:03 -0700119 // topologicalReorder is before resolveInheritance, as we
Timur Iskhakov77dd65c2017-08-31 22:46:56 -0700120 // need to have no cycle while getting parent class.
Timur Iskhakov458ca362017-09-12 23:16:03 -0700121 err = topologicalReorder();
Timur Iskhakov77dd65c2017-08-31 22:46:56 -0700122 if (err != OK) return err;
123 err = resolveInheritance();
124 if (err != OK) return err;
Steven Moreland12f0ab12018-11-02 17:27:37 -0700125 err = lookupConstantExpressions();
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700126 if (err != OK) return err;
Timur Iskhakov77dd65c2017-08-31 22:46:56 -0700127 // checkAcyclicConstantExpressions is after resolveInheritance,
128 // as resolveInheritance autofills enum values.
129 err = checkAcyclicConstantExpressions();
Timur Iskhakov33431e62017-08-21 17:31:23 -0700130 if (err != OK) return err;
Steven Moreland12f0ab12018-11-02 17:27:37 -0700131 err = validateConstantExpressions();
132 if (err != OK) return err;
133 err = evaluateConstantExpressions();
Timur Iskhakov33431e62017-08-21 17:31:23 -0700134 if (err != OK) return err;
135 err = validate();
136 if (err != OK) return err;
Timur Iskhakov041fdfe2017-09-06 15:56:01 -0700137 err = checkForwardReferenceRestrictions();
138 if (err != OK) return err;
Andreas Huber308d8a22017-11-06 14:46:52 -0800139 err = gatherReferencedTypes();
140 if (err != OK) return err;
Timur Iskhakov33431e62017-08-21 17:31:23 -0700141
Timur Iskhakov35930c42017-08-28 18:49:54 -0700142 // Make future packages not to call passes
143 // for processed types and expressions
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700144 constantExpressionRecursivePass(
145 [](ConstantExpression* ce) {
146 ce->setPostParseCompleted();
147 return OK;
148 },
149 true /* processBeforeDependencies */);
Yifan Hong0e192c42018-10-23 15:32:19 -0700150
151 err = setParseStage(Type::ParseStage::POST_PARSE, Type::ParseStage::COMPLETED);
152 if (err != OK) return err;
Timur Iskhakov35930c42017-08-28 18:49:54 -0700153
Timur Iskhakov33431e62017-08-21 17:31:23 -0700154 return OK;
155}
156
Timur Iskhakov891a8662017-08-25 21:53:48 -0700157status_t AST::constantExpressionRecursivePass(
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700158 const std::function<status_t(ConstantExpression*)>& func, bool processBeforeDependencies) {
Timur Iskhakov891a8662017-08-25 21:53:48 -0700159 std::unordered_set<const Type*> visitedTypes;
160 std::unordered_set<const ConstantExpression*> visitedCE;
Yifan Hong0e192c42018-10-23 15:32:19 -0700161 return mRootScope.recursivePass(Type::ParseStage::POST_PARSE,
162 [&](Type* type) -> status_t {
163 for (auto* ce : type->getConstantExpressions()) {
164 status_t err = ce->recursivePass(
165 func, &visitedCE, processBeforeDependencies);
166 if (err != OK) return err;
167 }
168 return OK;
169 },
170 &visitedTypes);
171}
172
Steven Moreland12f0ab12018-11-02 17:27:37 -0700173status_t AST::constantExpressionRecursivePass(
174 const std::function<status_t(const ConstantExpression*)>& func,
175 bool processBeforeDependencies) const {
176 std::unordered_set<const Type*> visitedTypes;
177 std::unordered_set<const ConstantExpression*> visitedCE;
178 return mRootScope.recursivePass(Type::ParseStage::POST_PARSE,
179 [&](const Type* type) -> status_t {
180 for (auto* ce : type->getConstantExpressions()) {
181 status_t err = ce->recursivePass(
182 func, &visitedCE, processBeforeDependencies);
183 if (err != OK) return err;
184 }
185 return OK;
186 },
187 &visitedTypes);
188}
189
Yifan Hong0e192c42018-10-23 15:32:19 -0700190status_t AST::setParseStage(Type::ParseStage oldStage, Type::ParseStage newStage) {
191 std::unordered_set<const Type*> visited;
192 return mRootScope.recursivePass(oldStage,
193 [oldStage, newStage](Type* type) {
194 CHECK(type->getParseStage() == oldStage);
195 type->setParseStage(newStage);
196 return OK;
197 },
198 &visited);
Timur Iskhakov891a8662017-08-25 21:53:48 -0700199}
200
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700201status_t AST::lookupTypes() {
202 std::unordered_set<const Type*> visited;
203 return mRootScope.recursivePass(
Yifan Hong0e192c42018-10-23 15:32:19 -0700204 Type::ParseStage::PARSE,
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700205 [&](Type* type) -> status_t {
206 Scope* scope = type->isScope() ? static_cast<Scope*>(type) : type->parent();
207
208 for (auto* nextRef : type->getReferences()) {
Andreas Huber308d8a22017-11-06 14:46:52 -0800209 if (nextRef->isResolved()) {
210 continue;
211 }
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700212
213 Type* nextType = lookupType(nextRef->getLookupFqName(), scope);
214 if (nextType == nullptr) {
215 std::cerr << "ERROR: Failed to lookup type '"
216 << nextRef->getLookupFqName().string() << "' at "
217 << nextRef->location() << "\n";
218 return UNKNOWN_ERROR;
219 }
220 nextRef->set(nextType);
221 }
222
223 return OK;
224 },
225 &visited);
226}
227
Andreas Huber308d8a22017-11-06 14:46:52 -0800228status_t AST::gatherReferencedTypes() {
229 std::unordered_set<const Type*> visited;
230 return mRootScope.recursivePass(
Yifan Hong0e192c42018-10-23 15:32:19 -0700231 Type::ParseStage::POST_PARSE,
Andreas Huber308d8a22017-11-06 14:46:52 -0800232 [&](Type* type) -> status_t {
233 for (auto* nextRef : type->getReferences()) {
234 const Type *targetType = nextRef->get();
235 if (targetType->isNamedType()) {
236 mReferencedTypeNames.insert(
237 static_cast<const NamedType *>(targetType)->fqName());
238 }
239 }
240
241 return OK;
242 },
243 &visited);
244}
245
Steven Moreland12f0ab12018-11-02 17:27:37 -0700246status_t AST::lookupConstantExpressions() {
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700247 std::unordered_set<const Type*> visitedTypes;
248 std::unordered_set<const ConstantExpression*> visitedCE;
249
250 return mRootScope.recursivePass(
Yifan Hong0e192c42018-10-23 15:32:19 -0700251 Type::ParseStage::POST_PARSE,
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700252 [&](Type* type) -> status_t {
253 Scope* scope = type->isScope() ? static_cast<Scope*>(type) : type->parent();
254
255 for (auto* ce : type->getConstantExpressions()) {
256 status_t err = ce->recursivePass(
257 [&](ConstantExpression* ce) {
258 for (auto* nextRef : ce->getReferences()) {
259 if (nextRef->isResolved()) continue;
260
261 LocalIdentifier* iden = lookupLocalIdentifier(*nextRef, scope);
262 if (iden == nullptr) return UNKNOWN_ERROR;
263 nextRef->set(iden);
264 }
Steven Moreland12f0ab12018-11-02 17:27:37 -0700265 for (auto* nextRef : ce->getTypeReferences()) {
266 if (nextRef->isResolved()) continue;
267
268 Type* nextType = lookupType(nextRef->getLookupFqName(), scope);
269 if (nextType == nullptr) {
270 std::cerr << "ERROR: Failed to lookup type '"
271 << nextRef->getLookupFqName().string() << "' at "
272 << nextRef->location() << "\n";
273 return UNKNOWN_ERROR;
274 }
275 nextRef->set(nextType);
276 }
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700277 return OK;
278 },
279 &visitedCE, true /* processBeforeDependencies */);
280 if (err != OK) return err;
281 }
282
283 return OK;
284 },
285 &visitedTypes);
286}
287
Timur Iskhakov565b0132017-09-06 18:07:11 -0700288status_t AST::validateDefinedTypesUniqueNames() const {
289 std::unordered_set<const Type*> visited;
290 return mRootScope.recursivePass(
Yifan Hong0e192c42018-10-23 15:32:19 -0700291 Type::ParseStage::POST_PARSE,
Timur Iskhakov565b0132017-09-06 18:07:11 -0700292 [&](const Type* type) -> status_t {
293 // We only want to validate type definition names in this place.
294 if (type->isScope()) {
295 return static_cast<const Scope*>(type)->validateUniqueNames();
296 }
297 return OK;
298 },
299 &visited);
300}
301
Timur Iskhakovcec46c42017-08-09 00:22:02 -0700302status_t AST::resolveInheritance() {
Timur Iskhakov33431e62017-08-21 17:31:23 -0700303 std::unordered_set<const Type*> visited;
Yifan Hong0e192c42018-10-23 15:32:19 -0700304 return mRootScope.recursivePass(Type::ParseStage::POST_PARSE, &Type::resolveInheritance,
305 &visited);
Timur Iskhakovcec46c42017-08-09 00:22:02 -0700306}
307
Steven Moreland12f0ab12018-11-02 17:27:37 -0700308status_t AST::validateConstantExpressions() const {
309 return constantExpressionRecursivePass(
310 [](const ConstantExpression* ce) { return ce->validate(); },
311 true /* processBeforeDependencies */);
312}
313
314status_t AST::evaluateConstantExpressions() {
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700315 return constantExpressionRecursivePass(
316 [](ConstantExpression* ce) {
317 ce->evaluate();
318 return OK;
319 },
320 false /* processBeforeDependencies */);
Timur Iskhakovcec46c42017-08-09 00:22:02 -0700321}
322
323status_t AST::validate() const {
Timur Iskhakov33431e62017-08-21 17:31:23 -0700324 std::unordered_set<const Type*> visited;
Yifan Hong0e192c42018-10-23 15:32:19 -0700325 return mRootScope.recursivePass(Type::ParseStage::POST_PARSE, &Type::validate, &visited);
Timur Iskhakovcec46c42017-08-09 00:22:02 -0700326}
327
Timur Iskhakov458ca362017-09-12 23:16:03 -0700328status_t AST::topologicalReorder() {
329 std::unordered_map<const Type*, size_t> reversedOrder;
Timur Iskhakov40731af2017-08-24 14:18:35 -0700330 std::unordered_set<const Type*> stack;
Timur Iskhakov458ca362017-09-12 23:16:03 -0700331 status_t err = mRootScope.topologicalOrder(&reversedOrder, &stack).status;
332 if (err != OK) return err;
333
334 std::unordered_set<const Type*> visited;
Yifan Hong0e192c42018-10-23 15:32:19 -0700335 mRootScope.recursivePass(Type::ParseStage::POST_PARSE,
336 [&](Type* type) {
337 if (type->isScope()) {
338 static_cast<Scope*>(type)->topologicalReorder(reversedOrder);
339 }
340 return OK;
341 },
342 &visited);
Timur Iskhakov458ca362017-09-12 23:16:03 -0700343 return OK;
Timur Iskhakov40731af2017-08-24 14:18:35 -0700344}
345
Timur Iskhakov77dd65c2017-08-31 22:46:56 -0700346status_t AST::checkAcyclicConstantExpressions() const {
347 std::unordered_set<const Type*> visitedTypes;
348 std::unordered_set<const ConstantExpression*> visitedCE;
349 std::unordered_set<const ConstantExpression*> stack;
Yifan Hong0e192c42018-10-23 15:32:19 -0700350 return mRootScope.recursivePass(Type::ParseStage::POST_PARSE,
351 [&](const Type* type) -> status_t {
352 for (auto* ce : type->getConstantExpressions()) {
353 status_t err =
354 ce->checkAcyclic(&visitedCE, &stack).status;
355 CHECK(err != OK || stack.empty());
356 if (err != OK) return err;
357 }
358 return OK;
359 },
360 &visitedTypes);
Timur Iskhakov77dd65c2017-08-31 22:46:56 -0700361}
362
Timur Iskhakov041fdfe2017-09-06 15:56:01 -0700363status_t AST::checkForwardReferenceRestrictions() const {
364 std::unordered_set<const Type*> visited;
Yifan Hong0e192c42018-10-23 15:32:19 -0700365 return mRootScope.recursivePass(Type::ParseStage::POST_PARSE,
366 [](const Type* type) -> status_t {
367 for (const Reference<Type>* ref : type->getReferences()) {
368 status_t err =
369 type->checkForwardReferenceRestrictions(*ref);
370 if (err != OK) return err;
371 }
372 return OK;
373 },
374 &visited);
Timur Iskhakov041fdfe2017-09-06 15:56:01 -0700375}
376
Neel Mehta8b0f06a2019-07-11 18:13:21 -0700377bool AST::importFQName(const FQName& fqName) {
Andreas Huber5345ec22016-07-29 13:33:27 -0700378 if (fqName.name().empty()) {
Yifan Hong1977ea32016-10-05 12:49:08 -0700379 // import a package
Andreas Huber4ba5c972017-11-29 11:06:25 -0800380
Andreas Huberd2943e12016-08-05 11:59:31 -0700381 std::vector<FQName> packageInterfaces;
Andreas Huber68f24592016-07-29 14:53:48 -0700382
Neel Mehta8b0f06a2019-07-11 18:13:21 -0700383 status_t err = mCoordinator->appendPackageInterfacesToVector(fqName, &packageInterfaces);
Andreas Huberd2943e12016-08-05 11:59:31 -0700384
385 if (err != OK) {
Andreas Huber68f24592016-07-29 14:53:48 -0700386 return false;
387 }
388
Neel Mehta8b0f06a2019-07-11 18:13:21 -0700389 for (const auto& subFQName : packageInterfaces) {
Andreas Huber4ba5c972017-11-29 11:06:25 -0800390 addToImportedNamesGranular(subFQName);
391
Yifan Hongf619fc72017-04-07 15:40:06 -0700392 // Do not enforce restrictions on imports.
Steven Morelandc59326e2017-06-20 15:19:30 -0700393 AST* ast = mCoordinator->parse(subFQName, &mImportedASTs, Coordinator::Enforce::NONE);
Yifan Hong1977ea32016-10-05 12:49:08 -0700394 if (ast == nullptr) {
Andreas Huber68f24592016-07-29 14:53:48 -0700395 return false;
396 }
Yifan Hong1977ea32016-10-05 12:49:08 -0700397 // all previous single type imports are ignored.
398 mImportedTypes.erase(ast);
Andreas Huber68f24592016-07-29 14:53:48 -0700399 }
400
401 return true;
Andreas Huber5345ec22016-07-29 13:33:27 -0700402 }
403
Andreas Huber4ba5c972017-11-29 11:06:25 -0800404 addToImportedNamesGranular(fqName);
405
Yifan Hong1977ea32016-10-05 12:49:08 -0700406 // cases like android.hardware.foo@1.0::IFoo.Internal
407 // android.hardware.foo@1.0::Abc.Internal
408
409 // assume it is an interface, and try to import it.
410 const FQName interfaceName = fqName.getTopLevelType();
Yifan Hongf619fc72017-04-07 15:40:06 -0700411 // Do not enforce restrictions on imports.
Steven Moreland71f09132018-02-20 12:24:30 -0800412 AST* importAST;
413 status_t err = mCoordinator->parseOptional(interfaceName, &importAST, &mImportedASTs,
414 Coordinator::Enforce::NONE);
415 if (err != OK) return false;
416 // importAST nullptr == file doesn't exist
Yifan Hong1977ea32016-10-05 12:49:08 -0700417
418 if (importAST != nullptr) {
419 // cases like android.hardware.foo@1.0::IFoo.Internal
420 // and android.hardware.foo@1.0::IFoo
421 if (fqName == interfaceName) {
422 // import a single file.
423 // all previous single type imports are ignored.
424 // cases like android.hardware.foo@1.0::IFoo
425 // and android.hardware.foo@1.0::types
426 mImportedTypes.erase(importAST);
427 return true;
428 }
429
430 // import a single type from this file
431 // cases like android.hardware.foo@1.0::IFoo.Internal
432 FQName matchingName;
Neel Mehta8b0f06a2019-07-11 18:13:21 -0700433 Type* match = importAST->findDefinedType(fqName, &matchingName);
Yifan Hong1977ea32016-10-05 12:49:08 -0700434 if (match == nullptr) {
435 return false;
436 }
437 // will automatically create a set if it does not exist
438 mImportedTypes[importAST].insert(match);
439 return true;
Andreas Huber68f24592016-07-29 14:53:48 -0700440 }
Andreas Huber84f89de2016-07-28 15:39:51 -0700441
Yifan Hong1977ea32016-10-05 12:49:08 -0700442 // probably a type in types.hal, like android.hardware.foo@1.0::Abc.Internal
443 FQName typesFQName = fqName.getTypesForPackage();
Yifan Hongf619fc72017-04-07 15:40:06 -0700444
445 // Do not enforce restrictions on imports.
Steven Morelandc59326e2017-06-20 15:19:30 -0700446 importAST = mCoordinator->parse(typesFQName, &mImportedASTs, Coordinator::Enforce::NONE);
Yifan Hong1977ea32016-10-05 12:49:08 -0700447
448 if (importAST != nullptr) {
449 // Attempt to find Abc.Internal in types.
450 FQName matchingName;
Neel Mehta8b0f06a2019-07-11 18:13:21 -0700451 Type* match = importAST->findDefinedType(fqName, &matchingName);
Yifan Hong1977ea32016-10-05 12:49:08 -0700452 if (match == nullptr) {
453 return false;
454 }
455 // will automatically create a set if not exist
456 mImportedTypes[importAST].insert(match);
457 return true;
458 }
459
460 // can't find an appropriate AST for fqName.
461 return false;
Andreas Hubereb1081f2016-07-28 13:13:24 -0700462}
463
Neel Mehta8b0f06a2019-07-11 18:13:21 -0700464bool AST::addImplicitImport(const FQName& fqName) {
465 CHECK(fqName.isFullyQualified());
466
467 if (importFQName(fqName)) {
468 mImplicitImports.push_back(fqName);
469 return true;
470 }
471
472 return false;
473}
474
475bool AST::addImport(const char* import, const Location& location) {
476 FQName fqName;
477 if (!FQName::parse(import, &fqName)) {
478 std::cerr << "ERROR: '" << import << "' is an invalid fully-qualified name." << std::endl;
479 return false;
480 }
481
482 fqName.applyDefaults(mPackage.package(), mPackage.version());
483
484 if (importFQName(fqName)) {
485 mImportStatements.push_back({fqName, location});
486 return true;
487 }
488
489 return false;
490}
491
Andreas Huber39fa7182016-08-19 14:27:33 -0700492void AST::addImportedAST(AST *ast) {
493 mImportedASTs.insert(ast);
494}
495
Timur Iskhakov565b0132017-09-06 18:07:11 -0700496FQName AST::makeFullName(const char* localName, Scope* scope) const {
497 std::vector<std::string> pathComponents{{localName}};
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700498 for (; scope != &mRootScope; scope = scope->parent()) {
Neel Mehta9200af02019-07-19 13:24:57 -0700499 pathComponents.push_back(scope->definedName());
Andreas Huber31629bc2016-08-03 09:06:40 -0700500 }
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700501
502 std::reverse(pathComponents.begin(), pathComponents.end());
503 std::string path = StringHelper::JoinStrings(pathComponents, ".");
Andreas Huber31629bc2016-08-03 09:06:40 -0700504
Timur Iskhakov565b0132017-09-06 18:07:11 -0700505 return FQName(mPackage.package(), mPackage.version(), path);
506}
Andreas Huber39fa7182016-08-19 14:27:33 -0700507
Timur Iskhakov565b0132017-09-06 18:07:11 -0700508void AST::addScopedType(NamedType* type, Scope* scope) {
509 scope->addType(type);
510 mDefinedTypesByFullName[type->fqName()] = type;
Andreas Huber31629bc2016-08-03 09:06:40 -0700511}
512
Steven Moreland8f8e8622019-11-04 12:38:38 -0800513LocalIdentifier* AST::lookupLocalIdentifier(const Reference<LocalIdentifier>& ref,
514 const Scope* scope) {
Timur Iskhakov82c048e2017-09-09 01:20:53 -0700515 const FQName& fqName = ref.getLookupFqName();
516
517 if (fqName.isIdentifier()) {
518 LocalIdentifier* iden = scope->lookupIdentifier(fqName.name());
519 if (iden == nullptr) {
520 std::cerr << "ERROR: identifier " << fqName.string() << " could not be found at "
521 << ref.location() << "\n";
522 return nullptr;
523 }
524 return iden;
525 } else {
526 std::string errorMsg;
527 EnumValue* enumValue = lookupEnumValue(fqName, &errorMsg, scope);
528 if (enumValue == nullptr) {
529 std::cerr << "ERROR: " << errorMsg << " at " << ref.location() << "\n";
530 return nullptr;
531 }
532 return enumValue;
533 }
534}
535
Steven Moreland8f8e8622019-11-04 12:38:38 -0800536EnumValue* AST::lookupEnumValue(const FQName& fqName, std::string* errorMsg, const Scope* scope) {
Yifan Hongf24fa852016-09-23 11:03:15 -0700537 FQName enumTypeName = fqName.typeName();
538 std::string enumValueName = fqName.valueName();
539
Yifan Hongf24fa852016-09-23 11:03:15 -0700540 CHECK(!enumValueName.empty());
541
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700542 Type* type = lookupType(enumTypeName, scope);
Yifan Hongf24fa852016-09-23 11:03:15 -0700543 if(type == nullptr) {
544 *errorMsg = "Cannot find type " + enumTypeName.string();
545 return nullptr;
546 }
Steven Morelandd965ce92017-11-27 16:05:34 -0800547 type = type->resolve();
Yifan Hongf24fa852016-09-23 11:03:15 -0700548 if(!type->isEnum()) {
549 *errorMsg = "Type " + enumTypeName.string() + " is not an enum type";
550 return nullptr;
551 }
552
553 EnumType *enumType = static_cast<EnumType *>(type);
554 EnumValue *v = static_cast<EnumValue *>(enumType->lookupIdentifier(enumValueName));
555 if(v == nullptr) {
556 *errorMsg = "Enum type " + enumTypeName.string() + " does not have " + enumValueName;
557 return nullptr;
558 }
Andreas Huber4ba5c972017-11-29 11:06:25 -0800559
560 mReferencedTypeNames.insert(enumType->fqName());
561
Yifan Hongf24fa852016-09-23 11:03:15 -0700562 return v;
563}
564
Steven Moreland8f8e8622019-11-04 12:38:38 -0800565Type* AST::lookupType(const FQName& fqName, const Scope* scope) {
Andreas Huberda51b8e2016-07-28 16:00:57 -0700566 if (fqName.name().empty()) {
567 // Given a package and version???
Yifan Hong1977ea32016-10-05 12:49:08 -0700568 return nullptr;
Andreas Huberda51b8e2016-07-28 16:00:57 -0700569 }
570
Yifan Hong87ff8232017-01-09 12:07:05 -0800571 Type *returnedType = nullptr;
572
Andreas Huber84f89de2016-07-28 15:39:51 -0700573 if (fqName.package().empty() && fqName.version().empty()) {
Yifan Hong87ff8232017-01-09 12:07:05 -0800574 // resolve locally first if possible.
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700575 returnedType = lookupTypeLocally(fqName, scope);
Yifan Hong87ff8232017-01-09 12:07:05 -0800576 if (returnedType != nullptr) {
577 return returnedType;
Andreas Huberc9410c72016-07-28 12:18:40 -0700578 }
579 }
580
Steven Moreland87e69dc2017-09-12 18:14:28 -0700581 status_t status = lookupAutofilledType(fqName, &returnedType);
582 if (status != OK) {
583 return nullptr;
584 }
585 if (returnedType != nullptr) {
586 return returnedType;
Yifan Hong87ff8232017-01-09 12:07:05 -0800587 }
588
589 return lookupTypeFromImports(fqName);
590}
591
592// Rule 0: try resolve locally
Steven Moreland8f8e8622019-11-04 12:38:38 -0800593Type* AST::lookupTypeLocally(const FQName& fqName, const Scope* scope) {
Yifan Hong87ff8232017-01-09 12:07:05 -0800594 CHECK(fqName.package().empty() && fqName.version().empty()
595 && !fqName.name().empty() && fqName.valueName().empty());
596
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700597 for (; scope != nullptr; scope = scope->parent()) {
598 Type* type = scope->lookupType(fqName);
Yifan Hong87ff8232017-01-09 12:07:05 -0800599 if (type != nullptr) {
Yifan Hong87ff8232017-01-09 12:07:05 -0800600 return type;
601 }
602 }
603
604 return nullptr;
605}
606
607// Rule 1: auto-fill with current package
608status_t AST::lookupAutofilledType(const FQName &fqName, Type **returnedType) {
Steven Moreland87e69dc2017-09-12 18:14:28 -0700609 CHECK(!fqName.name().empty() && fqName.valueName().empty());
Yifan Hong87ff8232017-01-09 12:07:05 -0800610
611 FQName autofilled = fqName;
612 autofilled.applyDefaults(mPackage.package(), mPackage.version());
613 FQName matchingName;
614 // Given this fully-qualified name, the type may be defined in this AST, or other files
615 // in import.
616 Type *local = findDefinedType(autofilled, &matchingName);
617 CHECK(local == nullptr || autofilled == matchingName);
Steven Moreland87e69dc2017-09-12 18:14:28 -0700618 Type* fromImport = lookupTypeFromImports(autofilled);
Yifan Hong87ff8232017-01-09 12:07:05 -0800619
620 if (local != nullptr && fromImport != nullptr && local != fromImport) {
621 // Something bad happen; two types have the same FQName.
622 std::cerr << "ERROR: Unable to resolve type name '"
623 << fqName.string()
624 << "' (i.e. '"
625 << autofilled.string()
626 << "'), multiple definitions found.\n";
627
628 return UNKNOWN_ERROR;
629 }
630 if (local != nullptr) {
631 *returnedType = local;
632 return OK;
633 }
634 // If fromImport is nullptr as well, return nullptr to fall through to next rule.
635 *returnedType = fromImport;
636 return OK;
637}
638
639// Rule 2: look at imports
640Type *AST::lookupTypeFromImports(const FQName &fqName) {
641
Andreas Huber39fa7182016-08-19 14:27:33 -0700642 Type *resolvedType = nullptr;
Iliyan Malchev800273d2016-09-02 15:25:07 -0700643 Type *returnedType = nullptr;
Andreas Huber39fa7182016-08-19 14:27:33 -0700644 FQName resolvedName;
Andreas Huber84f89de2016-07-28 15:39:51 -0700645
Andreas Huber39fa7182016-08-19 14:27:33 -0700646 for (const auto &importedAST : mImportedASTs) {
Yifan Hong1977ea32016-10-05 12:49:08 -0700647 if (mImportedTypes.find(importedAST) != mImportedTypes.end()) {
648 // ignore single type imports
649 continue;
650 }
Andreas Huber39fa7182016-08-19 14:27:33 -0700651 FQName matchingName;
652 Type *match = importedAST->findDefinedType(fqName, &matchingName);
Andreas Huber84f89de2016-07-28 15:39:51 -0700653
Andreas Huber39fa7182016-08-19 14:27:33 -0700654 if (match != nullptr) {
655 if (resolvedType != nullptr) {
656 std::cerr << "ERROR: Unable to resolve type name '"
657 << fqName.string()
658 << "', multiple matches found:\n";
Andreas Huber737080b2016-08-02 15:38:04 -0700659
Andreas Huber39fa7182016-08-19 14:27:33 -0700660 std::cerr << " " << resolvedName.string() << "\n";
661 std::cerr << " " << matchingName.string() << "\n";
662
Yifan Hong1977ea32016-10-05 12:49:08 -0700663 return nullptr;
664 }
665
666 resolvedType = match;
667 returnedType = resolvedType;
668 resolvedName = matchingName;
669
670 // Keep going even after finding a match.
671 }
672 }
673
674 for (const auto &pair : mImportedTypes) {
675 AST *importedAST = pair.first;
676 std::set<Type *> importedTypes = pair.second;
677
678 FQName matchingName;
679 Type *match = importedAST->findDefinedType(fqName, &matchingName);
680 if (match != nullptr &&
681 importedTypes.find(match) != importedTypes.end()) {
682 if (resolvedType != nullptr) {
683 std::cerr << "ERROR: Unable to resolve type name '"
684 << fqName.string()
685 << "', multiple matches found:\n";
686
687 std::cerr << " " << resolvedName.string() << "\n";
688 std::cerr << " " << matchingName.string() << "\n";
689
690 return nullptr;
Andreas Huber39fa7182016-08-19 14:27:33 -0700691 }
692
693 resolvedType = match;
Iliyan Malchev800273d2016-09-02 15:25:07 -0700694 returnedType = resolvedType;
Andreas Huber39fa7182016-08-19 14:27:33 -0700695 resolvedName = matchingName;
696
697 // Keep going even after finding a match.
698 }
699 }
700
701 if (resolvedType) {
Iliyan Malchev800273d2016-09-02 15:25:07 -0700702 returnedType = resolvedType;
703
704 // If the resolved type is not an interface, we need to determine
705 // whether it is defined in types.hal, or in some other interface. In
706 // the latter case, we need to emit a dependency for the interface in
707 // which the type is defined.
708 //
709 // Consider the following:
710 // android.hardware.tests.foo@1.0::Record
711 // android.hardware.tests.foo@1.0::IFoo.Folder
712 // android.hardware.tests.foo@1.0::Folder
713 //
714 // If Record is an interface, then we keep track of it for the purpose
715 // of emitting dependencies in the target language (for example #include
716 // in C++). If Record is a UDT, then we assume it is defined in
717 // types.hal in android.hardware.tests.foo@1.0.
718 //
719 // In the case of IFoo.Folder, the same applies. If IFoo is an
720 // interface, we need to track this for the purpose of emitting
721 // dependencies. If not, then it must have been defined in types.hal.
722 //
723 // In the case of just specifying Folder, the resolved type is
Yifan Hongfece6ec2017-01-12 17:04:04 -0800724 // android.hardware.tests.foo@1.0::Folder, and the same logic as
Iliyan Malchev800273d2016-09-02 15:25:07 -0700725 // above applies.
726
727 if (!resolvedType->isInterface()) {
Yifan Hongfece6ec2017-01-12 17:04:04 -0800728 FQName ifc = resolvedName.getTopLevelType();
Iliyan Malchev800273d2016-09-02 15:25:07 -0700729 for (const auto &importedAST : mImportedASTs) {
730 FQName matchingName;
731 Type *match = importedAST->findDefinedType(ifc, &matchingName);
732 if (match != nullptr && match->isInterface()) {
733 resolvedType = match;
734 }
735 }
736 }
737
Andreas Huber39fa7182016-08-19 14:27:33 -0700738 if (!resolvedType->isInterface()) {
Andreas Huber0e00de42016-08-03 09:56:02 -0700739 // Non-interface types are declared in the associated types header.
Yifan Hongfece6ec2017-01-12 17:04:04 -0800740 FQName typesName = resolvedName.getTypesForPackage();
Andreas Huber39fa7182016-08-19 14:27:33 -0700741
Andreas Huber0e00de42016-08-03 09:56:02 -0700742 mImportedNames.insert(typesName);
743 } else {
Andreas Huberbfd76212016-08-09 11:12:16 -0700744 // Do _not_ use fqName, i.e. the name we used to look up the type,
745 // but instead use the name of the interface we found.
746 // This is necessary because if fqName pointed to a typedef which
747 // in turn referenced the found interface we'd mistakenly use the
748 // name of the typedef instead of the proper name of the interface.
749
Andreas Huber4ba5c972017-11-29 11:06:25 -0800750 const FQName &typeName =
751 static_cast<Interface *>(resolvedType)->fqName();
752
753 mImportedNames.insert(typeName);
Andreas Huber0e00de42016-08-03 09:56:02 -0700754 }
Andreas Huber737080b2016-08-02 15:38:04 -0700755 }
756
Steven Morelandbb5c80b2016-10-05 11:07:36 -0700757 return returnedType;
Andreas Huber5345ec22016-07-29 13:33:27 -0700758}
759
Andreas Huber4ba5c972017-11-29 11:06:25 -0800760void AST::addToImportedNamesGranular(const FQName &fqName) {
761 if (fqName.package() == package().package()
762 && fqName.version() == package().version()) {
763 // Our own names are _defined_ here, not imported.
764 return;
765 }
766
767 mImportedNamesGranular.insert(fqName);
768}
769
Andreas Huber39fa7182016-08-19 14:27:33 -0700770Type *AST::findDefinedType(const FQName &fqName, FQName *matchingName) const {
Steven Morelandd537ab02016-09-12 10:32:01 -0700771 for (const auto &pair : mDefinedTypesByFullName) {
772 const FQName &key = pair.first;
773 Type* type = pair.second;
Andreas Huber5345ec22016-07-29 13:33:27 -0700774
Andreas Huber39fa7182016-08-19 14:27:33 -0700775 if (key.endsWith(fqName)) {
776 *matchingName = key;
Steven Morelandd537ab02016-09-12 10:32:01 -0700777 return type;
Andreas Huber5345ec22016-07-29 13:33:27 -0700778 }
Andreas Huber5345ec22016-07-29 13:33:27 -0700779 }
Andreas Huber39fa7182016-08-19 14:27:33 -0700780
781 return nullptr;
Andreas Huberc9410c72016-07-28 12:18:40 -0700782}
783
Neel Mehta55c065e2019-05-31 13:30:12 -0700784const std::vector<ImportStatement>& AST::getImportStatements() const {
785 return mImportStatements;
786}
787
Iliyan Malchev5bb14022016-08-09 15:04:39 -0700788void AST::getImportedPackages(std::set<FQName> *importSet) const {
Steven Moreland06a81cf2018-01-17 11:13:46 -0800789 for (const auto& fqName : mImportedNamesGranular) {
Yifan Hongfece6ec2017-01-12 17:04:04 -0800790 FQName packageName = fqName.getPackageAndVersion();
Andreas Huberd2943e12016-08-05 11:59:31 -0700791
792 if (packageName == mPackage) {
793 // We only care about external imports, not our own package.
794 continue;
795 }
796
797 importSet->insert(packageName);
798 }
799}
800
Yifan Hong40a373d2016-11-30 15:16:47 -0800801void AST::getImportedPackagesHierarchy(std::set<FQName> *importSet) const {
802 getImportedPackages(importSet);
Steven Moreland06a81cf2018-01-17 11:13:46 -0800803
Yifan Hong40a373d2016-11-30 15:16:47 -0800804 std::set<FQName> newSet;
805 for (const auto &ast : mImportedASTs) {
806 if (importSet->find(ast->package()) != importSet->end()) {
807 ast->getImportedPackagesHierarchy(&newSet);
808 }
809 }
810 importSet->insert(newSet.begin(), newSet.end());
811}
812
Zhuoyao Zhangc4e10602017-01-27 16:48:05 -0800813void AST::getAllImportedNames(std::set<FQName> *allImportNames) const {
814 for (const auto& name : mImportedNames) {
815 allImportNames->insert(name);
Steven Morelandc59326e2017-06-20 15:19:30 -0700816 AST* ast = mCoordinator->parse(name, nullptr /* imported */, Coordinator::Enforce::NONE);
Zhuoyao Zhangc4e10602017-01-27 16:48:05 -0800817 ast->getAllImportedNames(allImportNames);
818 }
819}
820
Andreas Huber4ba5c972017-11-29 11:06:25 -0800821void AST::getAllImportedNamesGranular(std::set<FQName> *allImportNames) const {
822 for (const auto& fqName : mImportedNamesGranular) {
823 if (fqName.name() == "types") {
824 // A package will export everything _defined_ but will not
825 // re-export anything it itself imported.
826 AST* ast = mCoordinator->parse(
827 fqName, nullptr /* imported */, Coordinator::Enforce::NONE);
828
829 ast->addDefinedTypes(allImportNames);
830 } else {
831 allImportNames->insert(fqName);
832 }
833 }
834}
835
Andreas Huber0fa9e392016-08-31 09:05:44 -0700836bool AST::isJavaCompatible() const {
Timur Iskhakov5dc72fe2017-09-07 23:13:44 -0700837 return mRootScope.isJavaCompatible();
Andreas Huber0fa9e392016-08-31 09:05:44 -0700838}
839
Andreas Huber019d21d2016-10-03 12:59:47 -0700840void AST::appendToExportedTypesVector(
841 std::vector<const Type *> *exportedTypes) const {
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700842 mRootScope.appendToExportedTypesVector(exportedTypes);
Andreas Huber019d21d2016-10-03 12:59:47 -0700843}
844
Yifan Hongc8934042016-11-17 17:10:52 -0800845bool AST::isIBase() const {
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700846 Interface* iface = mRootScope.getInterface();
Yifan Hongc8934042016-11-17 17:10:52 -0800847 return iface != nullptr && iface->isIBase();
848}
849
Yifan Hong78b38d12017-02-13 18:14:46 +0000850const Interface *AST::getInterface() const {
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700851 return mRootScope.getInterface();
Yifan Hong78b38d12017-02-13 18:14:46 +0000852}
853
Steven Moreland19f11b52017-05-12 18:22:21 -0700854std::string AST::getBaseName() const {
Timur Iskhakovcb0ba522017-07-17 20:01:37 -0700855 const Interface* iface = mRootScope.getInterface();
Steven Moreland19f11b52017-05-12 18:22:21 -0700856
857 return iface ? iface->getBaseName() : "types";
858}
859
Andreas Huber308d8a22017-11-06 14:46:52 -0800860void AST::addDefinedTypes(std::set<FQName> *definedTypes) const {
861 std::for_each(
862 mDefinedTypesByFullName.begin(),
863 mDefinedTypesByFullName.end(),
864 [definedTypes](const auto &elem) {
865 if (!elem.second->isTypeDef()) {
866 definedTypes->insert(elem.first);
867 }
868 });
869}
870
871void AST::addReferencedTypes(std::set<FQName> *referencedTypes) const {
872 std::for_each(
873 mReferencedTypeNames.begin(),
874 mReferencedTypeNames.end(),
875 [referencedTypes](const auto &fqName) {
876 referencedTypes->insert(fqName);
877 });
878}
879
Neel Mehta0ee353f2019-05-30 17:40:29 -0700880bool AST::addMethod(Method* method, Interface* iface) {
881 if (iface->isIBase()) {
882 if (!mAllReservedMethods.emplace(method->name(), method).second) {
883 std::cerr << "ERROR: hidl-gen encountered duplicated reserved method " << method->name()
884 << std::endl;
885 return false;
886 }
887
888 // methods will be added to iface in addAllReservedMethodsToInterface
889 return true;
890 }
891
892 iface->addUserDefinedMethod(method);
893
894 return true;
895}
896
897bool AST::addAllReservedMethodsToInterface(Interface* iface) {
898 std::map<std::string, Method*> allReservedMethods(mAllReservedMethods);
899 // Looking for the IBase AST which is imported for all interfaces that are not IBase
900 for (const AST* importedAST : mImportedASTs) {
901 allReservedMethods.insert(importedAST->mAllReservedMethods.begin(),
902 importedAST->mAllReservedMethods.end());
903 }
904
905 return iface->addAllReservedMethods(allReservedMethods);
906}
907
Steven Moreland4d89ee22019-03-08 13:25:32 -0800908void AST::setHeader(const DocComment* header) {
909 mHeader = header;
910}
911
912const DocComment* AST::getHeader() const {
913 return mHeader;
914}
915
916void AST::addUnhandledComment(const DocComment* docComment) {
917 if (docComment != nullptr) mUnhandledComments.push_back(docComment);
918}
919
920const std::vector<const DocComment*> AST::getUnhandledComments() const {
921 return mUnhandledComments;
922}
923
Andreas Huberc9410c72016-07-28 12:18:40 -0700924} // namespace android;