Балерина V 1.0 - Ошибка в вызове функции с jdbc: тип возврата клиента - недокументированный параметр возврата - PullRequest
1 голос
/ 09 октября 2019

Мне нужно вызвать функцию в test.bal. Функция записана в файле function.bal в том же модуле. Возвращаемый тип функции: jdbc: Client .

function.bal:

import ballerinax/java.jdbc;

public function createDbConn() returns jdbc:Client{
    jdbc:Client testDbConn = new({
    url: "jdbc:mysql://localhost:3306/testDB",
    username: "testUsername",
    password: "testPassword",
    poolOptions: {maximumPoolSize: 5},
    dbOptions: {useSSL: false}
    });
return testDbConn;
}

Перед вызовом этого метода в test.bal ошибки компиляции нет. Затем я пытаюсь вызвать функцию в test.bal, как показано ниже

jdbc:Client testDbConn = createDbConn();

...//more code in here
var selectFromDb = testDbConn->select("SELECT * FROM test", testData);

После вызова метода это приводит к ошибке компиляции следующим образом в function.bal

недокументированный возвратпараметр

В чем причина этой ошибки? Не могу ли я использовать jdbc: Client в качестве типа возврата?

PS: Это предупреждение, а не ошибка компиляции

1 Ответ

1 голос
/ 09 октября 2019
undocumented return parameter

должно быть предупреждением, это когда у вас есть неполная документация по функциям.

Но простой вызов функции не должен выдавать такого рода предупреждение о документации.

Можете ли вы попробовать добавить к этому методу документацию, возвращающую метод.

# + return - This is the description of the return value of
#            the `doThatOnObject` function.

См. Примеры комментариев к документу Ballerina здесь .

Если ошибка не устраненапожалуйста, сообщите об ошибке на https://github.com/ballerina-platform/ballerina-lang/issues

...