インタフェース Orm
-
- すべてのスーパーインタフェース:
CommandExecutor,SqlExecutor
- 既知のサブインタフェースのリスト:
OrmConnection,OrmTransaction,Sorm
public interface Orm extends CommandExecutor, SqlExecutor
ORM functions with an instant connection. When executing ORM function, this object gets a connection and executes the function, after that closes the connection immediately.- 作成者:
- nkjm
-
-
メソッドの概要
すべてのメソッド インスタンス・メソッド abstractメソッド 修飾子とタイプ メソッド 説明 <T> int[]delete(List<T> objects)Deletes objects from the table corresponding to the class of the given objects.<T> intdelete(T object)Deletes an object from the table corresponding to the class of the given objects.<T> int[]delete(T... objects)Deletes objects.<T> intdeleteAll(Class<T> type)Deletes all objects on the table corresponding to the given class.intdeleteAllOn(String tableName)Deletes all objects on the table corresponding to the given table name.<T> int[]deleteOn(String tableName, List<T> objects)Deletes objects on the table of the given table name.<T> intdeleteOn(String tableName, T object)Deletes object on the table of the given table name.<T> int[]deleteOn(String tableName, T... objects)Deletes objects on the table of the given table name.<T> booleanexists(String tableName, T object)Returns the object which has same primary key exists or not.<T> booleanexists(T object)Returns the object which has same primary key exists or not.ResultSetTraverser<List<Map<String,Object>>>getResultSetToMapTraverser()Gets function which traverses and maps the all the rows in the given resultSet to an object list.<T> ResultSetTraverser<List<T>>getResultSetTraverser(Class<T> type)Gets function which traverses and maps the all the rows in the given resultSet to an object list.<T> RowMapper<T>getRowMapper(Class<T> type)Gets a function which maps one row in the resultSet to an object.RowMapper<Map<String,Object>>getRowToMapMapper()Gets a function which maps one row in the resultSet to an object.TableMetaDatagetTableMetaData(Class<?> type)Gets table metadata corresponding to the given object class.TableMetaDatagetTableMetaData(String tableName)Gets table metadata to the given object class and the table name.StringgetTableName(Class<?> type)Gets table name corresponding to the given object class.<T> int[]insert(List<T> objects)Inserts objects on the table corresponding to the class of the given objects.<T> intinsert(T object)Inserts object on the table corresponding to the class of the given object.<T> int[]insert(T... objects)Insert objects on the table corresponding to the class of the given objects.<T> InsertResult<T>insertAndGet(List<T> objects)Inserts objects and get the last insert result.<T> InsertResult<T>insertAndGet(T object)Inserts an object and get the result.<T> InsertResult<T>insertAndGet(T... objects)Inserts objects and get the last insert result.<T> InsertResult<T>insertAndGetOn(String tableName, List<T> objects)Inserts objects and get the last insert result.<T> InsertResult<T>insertAndGetOn(String tableName, T object)Inserts an object and get the insert result.<T> InsertResult<T>insertAndGetOn(String tableName, T... objects)Inserts objects and get the last insert result.int[]insertMapOn(String tableName, List<Map<String,Object>> objects)This method is experimental.intinsertMapOn(String tableName, Map<String,Object> object)int[]insertMapOn(String tableName, Map<String,Object>... objects)This method is experimental.<T> int[]insertOn(String tableName, List<T> objects)Inserts objects and get the last insert result.<T> intinsertOn(String tableName, T object)Inserts an object and get the insert result.<T> int[]insertOn(String tableName, T... objects)Inserts objects and get the last insert result.<T> int[]merge(List<T> objects)Merges by objects on the table corresponding to the class of the given objects.<T> intmerge(T object)Merges by an object on the table corresponding to the class of the given object.<T> int[]merge(T... objects)Merges by objects on the table corresponding to the class of the given objects.<T> int[]mergeOn(String tableName, List<T> objects)Merges by objects on the table corresponding to the given table name.<T> intmergeOn(String tableName, T object)Merges by an object on the table corresponding to the given table name.<T> int[]mergeOn(String tableName, T... objects)Merges by objects on the table corresponding to the given table name.<T> List<T>readAll(Class<T> type)Reads all rows from the table indicated by object class.<T> LazyResultSet<T>readAllLazy(Class<T> type)ReturnsLazyResultSetrepresents all rows from the table indicated by object class.<T> TreadByPrimaryKey(Class<T> type, Object... primaryKeyValues)Reads an object by its primary keys from the table indicated by object class.<T> TreadFirst(Class<T> type, String sql, Object... parameters)Reads an object from the database.<T> TreadFirst(Class<T> type, ParameterizedSql sql)Reads an object from the database.<T> LazyResultSet<T>readLazy(Class<T> type, String sql, Object... parameters)Returns anLazyResultSet.<T> LazyResultSet<T>readLazy(Class<T> type, ParameterizedSql sql)Returns anLazyResultSet.<T> List<T>readList(Class<T> type, String sql, Object... parameters)Reads a list of objects from the database by mapping the results of the parameterized SQL query into instances of the given object class.<T> List<T>readList(Class<T> type, ParameterizedSql sql)Reads a list of objects from the database by mapping the results of the parameterized SQL query into instances of the given object class.Map<String,Object>readMapFirst(String sql, Object... parameters)Reads a first row from the database by mapping the results of the SQL query into an instance ofMap.Map<String,Object>readMapFirst(ParameterizedSql sql)LazyResultSet<Map<String,Object>>readMapLazy(String sql, Object... parameters)Returns anLazyResultSetinstance containing data from the execution of the provided parametrized SQL and convert it to Stream, List, and so on.LazyResultSet<Map<String,Object>>readMapLazy(ParameterizedSql sql)List<Map<String,Object>>readMapList(String sql, Object... parameters)Reads a list of objects from the database by mapping the SQL execution results to instances ofMapcontaining data from the execution of the provided parameterized SQL.List<Map<String,Object>>readMapList(ParameterizedSql sql)Map<String,Object>readMapOne(String sql, Object... parameters)Reads a first row from the database by mapping the results of the SQL query into an instance ofMap.Map<String,Object>readMapOne(ParameterizedSql sql)<T> TreadOne(Class<T> type, String sql, Object... parameters)Reads only one object from the database.<T> TreadOne(Class<T> type, ParameterizedSql sql)Reads only one object from the database.<T1,T2,T3>
List<Tuple3<T1,T2,T3>>readTupleList(Class<T1> t1, Class<T2> t2, Class<T3> t3, String sql, Object... parameters)Reads results as List ofTuple3for reading JOIN SQL results typically.<T1,T2,T3>
List<Tuple3<T1,T2,T3>>readTupleList(Class<T1> t1, Class<T2> t2, Class<T3> t3, ParameterizedSql sql)Reads results as List ofTuple3for reading JOIN SQL results typically.<T1,T2>
List<Tuple2<T1,T2>>readTupleList(Class<T1> t1, Class<T2> t2, String sql, Object... parameters)Reads results as List ofTuple2for reading JOIN SQL results typically.<T1,T2>
List<Tuple2<T1,T2>>readTupleList(Class<T1> t1, Class<T2> t2, ParameterizedSql sql)Reads results as List ofTuple2for reading JOIN SQL results typically.<T> int[]update(List<T> objects)Updates by objects on the table corresponding to the class of the given objects.<T> intupdate(T object)Updates by an object on the table corresponding to the class of the given object.<T> int[]update(T... objects)Updates by objects on the table corresponding to the class of the given objects.<T> int[]updateOn(String tableName, List<T> objects)Updates by objects on the table corresponding to the given table name.<T> intupdateOn(String tableName, T object)Updates by an object on the table corresponding to the given table name.<T> int[]updateOn(String tableName, T... objects)Updates by objects on the table corresponding to the given table name.-
インタフェースから継承されたメソッド org.nkjmlab.sorm4j.command.CommandExecutor
createCommand, createCommand, createCommand, createCommand
-
インタフェースから継承されたメソッド org.nkjmlab.sorm4j.basic.SqlExecutor
executeQuery, executeQuery, executeQuery, executeQuery, executeUpdate, executeUpdate
-
-
-
-
メソッドの詳細
-
delete
<T> int[] delete(List<T> objects)
Deletes objects from the table corresponding to the class of the given objects.- 型パラメータ:
T- the object's element type which is mapped to the unique table.- パラメータ:
objects- the objects to delete to- 戻り値:
- the number of affected rows
-
delete
<T> int delete(T object)
Deletes an object from the table corresponding to the class of the given objects.- 型パラメータ:
T- the object's type which is mapped to the unique table.- パラメータ:
object- the object to delete to- 戻り値:
- the number of affected rows
-
delete
<T> int[] delete(T... objects)
Deletes objects.- 型パラメータ:
T- the object's element type which is mapped to the unique table.- パラメータ:
objects-- 戻り値:
-
deleteAll
<T> int deleteAll(Class<T> type)
Deletes all objects on the table corresponding to the given class.- 型パラメータ:
T- the type to indicate the unique table.- パラメータ:
type- the type to indicate the unique table.- 戻り値:
-
deleteAllOn
int deleteAllOn(String tableName)
Deletes all objects on the table corresponding to the given table name.- パラメータ:
tableName-- 戻り値:
-
deleteOn
<T> int[] deleteOn(String tableName, List<T> objects)
Deletes objects on the table of the given table name.- 型パラメータ:
T- the object's element type.- パラメータ:
tableName-objects-- 戻り値:
-
deleteOn
<T> int deleteOn(String tableName, T object)
Deletes object on the table of the given table name.- 型パラメータ:
T- the object's type.- パラメータ:
tableName-object-- 戻り値:
-
deleteOn
<T> int[] deleteOn(String tableName, T... objects)
Deletes objects on the table of the given table name.- 型パラメータ:
T- the object's element type.- パラメータ:
tableName-objects-- 戻り値:
-
exists
<T> boolean exists(String tableName, T object)
Returns the object which has same primary key exists or not.- 型パラメータ:
T- the object's type.- パラメータ:
tableName-object-- 戻り値:
-
exists
<T> boolean exists(T object)
Returns the object which has same primary key exists or not.- 型パラメータ:
T- the object's type which is mapped to the unique table.- パラメータ:
object-- 戻り値:
-
getResultSetToMapTraverser
ResultSetTraverser<List<Map<String,Object>>> getResultSetToMapTraverser()
Gets function which traverses and maps the all the rows in the given resultSet to an object list.- 戻り値:
-
getResultSetTraverser
<T> ResultSetTraverser<List<T>> getResultSetTraverser(Class<T> type)
Gets function which traverses and maps the all the rows in the given resultSet to an object list.- 型パラメータ:
T- the read object's type.- パラメータ:
type-- 戻り値:
-
getRowMapper
<T> RowMapper<T> getRowMapper(Class<T> type)
Gets a function which maps one row in the resultSet to an object. The method does not callResultSet.next().- 型パラメータ:
T-- パラメータ:
type-- 戻り値:
-
getRowToMapMapper
RowMapper<Map<String,Object>> getRowToMapMapper()
Gets a function which maps one row in the resultSet to an object. The method does not callResultSet.next().- 戻り値:
-
getTableMetaData
TableMetaData getTableMetaData(Class<?> type)
Gets table metadata corresponding to the given object class.- パラメータ:
type-- 戻り値:
-
getTableMetaData
TableMetaData getTableMetaData(String tableName)
Gets table metadata to the given object class and the table name.- パラメータ:
tableName-- 戻り値:
-
getTableName
String getTableName(Class<?> type)
Gets table name corresponding to the given object class.- パラメータ:
type-- 戻り値:
-
insert
<T> int[] insert(List<T> objects)
Inserts objects on the table corresponding to the class of the given objects.- 型パラメータ:
T-- パラメータ:
objects-- 戻り値:
-
insert
<T> int insert(T object)
Inserts object on the table corresponding to the class of the given object.- 型パラメータ:
T-- パラメータ:
object-- 戻り値:
-
insert
<T> int[] insert(T... objects)
Insert objects on the table corresponding to the class of the given objects.- 型パラメータ:
T-- パラメータ:
objects-- 戻り値:
-
insertAndGet
<T> InsertResult<T> insertAndGet(List<T> objects)
Inserts objects and get the last insert result.- 型パラメータ:
T-- パラメータ:
objects-- 戻り値:
-
insertAndGet
<T> InsertResult<T> insertAndGet(T object)
Inserts an object and get the result.- 型パラメータ:
T-- パラメータ:
object-- 戻り値:
-
insertAndGet
<T> InsertResult<T> insertAndGet(T... objects)
Inserts objects and get the last insert result.- 型パラメータ:
T-- パラメータ:
objects-- 戻り値:
-
insertAndGetOn
<T> InsertResult<T> insertAndGetOn(String tableName, List<T> objects)
Inserts objects and get the last insert result.- 型パラメータ:
T-- パラメータ:
tableName-objects-- 戻り値:
-
insertAndGetOn
<T> InsertResult<T> insertAndGetOn(String tableName, T object)
Inserts an object and get the insert result.- 型パラメータ:
T-- パラメータ:
tableName-object-- 戻り値:
-
insertAndGetOn
<T> InsertResult<T> insertAndGetOn(String tableName, T... objects)
Inserts objects and get the last insert result.- 型パラメータ:
T-- パラメータ:
tableName-objects-- 戻り値:
-
insertMapOn
int[] insertMapOn(String tableName, List<Map<String,Object>> objects)
This method is experimental.- パラメータ:
tableName-objects-- 戻り値:
-
insertMapOn
int insertMapOn(String tableName, Map<String,Object> object)
- パラメータ:
tableName-object-- 戻り値:
-
insertMapOn
int[] insertMapOn(String tableName, Map<String,Object>... objects)
This method is experimental.- パラメータ:
tableName-objects-- 戻り値:
-
insertOn
<T> int[] insertOn(String tableName, List<T> objects)
Inserts objects and get the last insert result.- 型パラメータ:
T-- パラメータ:
tableName-objects-- 戻り値:
-
insertOn
<T> int insertOn(String tableName, T object)
Inserts an object and get the insert result.- 型パラメータ:
T-- パラメータ:
tableName-object-- 戻り値:
-
insertOn
<T> int[] insertOn(String tableName, T... objects)
Inserts objects and get the last insert result.- 型パラメータ:
T-- パラメータ:
tableName-objects-- 戻り値:
-
merge
<T> int[] merge(List<T> objects)
Merges by objects on the table corresponding to the class of the given objects.- 型パラメータ:
T-- パラメータ:
objects-- 戻り値:
- 関連項目:
merge(Object)
-
merge
<T> int merge(T object)
Merges by an object on the table corresponding to the class of the given object.Merge methods execute a SQL sentence as MERGE INTO of the H2 grammar. This operation may be not working the other database system. See, MERGE INTO - Commands
- 型パラメータ:
T-- パラメータ:
object-- 戻り値:
-
merge
<T> int[] merge(T... objects)
Merges by objects on the table corresponding to the class of the given objects.- 型パラメータ:
T-- パラメータ:
objects-- 戻り値:
- 関連項目:
merge(Object)
-
mergeOn
<T> int[] mergeOn(String tableName, List<T> objects)
Merges by objects on the table corresponding to the given table name.- 型パラメータ:
T-- パラメータ:
tableName-objects-- 戻り値:
-
mergeOn
<T> int mergeOn(String tableName, T object)
Merges by an object on the table corresponding to the given table name.- 型パラメータ:
T-- パラメータ:
tableName-object-- 戻り値:
-
mergeOn
<T> int[] mergeOn(String tableName, T... objects)
Merges by objects on the table corresponding to the given table name.- 型パラメータ:
T-- パラメータ:
tableName-objects-- 戻り値:
-
readAll
<T> List<T> readAll(Class<T> type)
Reads all rows from the table indicated by object class.- 型パラメータ:
T-- パラメータ:
type-- 戻り値:
-
readAllLazy
<T> LazyResultSet<T> readAllLazy(Class<T> type)
ReturnsLazyResultSetrepresents all rows from the table indicated by object class.- 型パラメータ:
T-- パラメータ:
type-- 戻り値:
-
readByPrimaryKey
<T> T readByPrimaryKey(Class<T> type, Object... primaryKeyValues)
Reads an object by its primary keys from the table indicated by object class.- 型パラメータ:
T-- パラメータ:
type-primaryKeyValues-- 戻り値:
-
readFirst
<T> T readFirst(Class<T> type, ParameterizedSql sql)
Reads an object from the database.- 型パラメータ:
T-- パラメータ:
type-sql-- 戻り値:
-
readFirst
<T> T readFirst(Class<T> type, String sql, Object... parameters)
Reads an object from the database.- 型パラメータ:
T-- パラメータ:
type-sql- with ordered parameter. The other type parameters (e.g. named parameter, list parameter) could not be used.parameters- are ordered parameter.- 戻り値:
-
readLazy
<T> LazyResultSet<T> readLazy(Class<T> type, ParameterizedSql sql)
Returns anLazyResultSet. It is able to convert to Stream, List, and so on.- 型パラメータ:
T-- パラメータ:
type-sql-- 戻り値:
-
readLazy
<T> LazyResultSet<T> readLazy(Class<T> type, String sql, Object... parameters)
Returns anLazyResultSet. It is able to convert to Stream, List, and so on.Parameters will be set according with the correspondence defined in
SqlParametersSetter.setParameters(SormOptions,PreparedStatement, Object[])- 型パラメータ:
T-- パラメータ:
type-sql-parameters-- 戻り値:
-
readList
<T> List<T> readList(Class<T> type, ParameterizedSql sql)
Reads a list of objects from the database by mapping the results of the parameterized SQL query into instances of the given object class. Only the columns returned from the SQL query will be set into the object instance. Example:ParameterizedSql sql = ParameterizedSql.from("select * from customer"); sorm.readList(Customer.class, sql);- 型パラメータ:
T-- パラメータ:
type-sql-- 戻り値:
-
readList
<T> List<T> readList(Class<T> type, String sql, Object... parameters)
Reads a list of objects from the database by mapping the results of the parameterized SQL query into instances of the given object class. Only the columns returned from the SQL query will be set into the object instance.Parameters will be set according with the correspondence defined in
SqlParametersSetter.setParameters(SormOptions, PreparedStatement, Object[])
-
readMapFirst
Map<String,Object> readMapFirst(ParameterizedSql sql)
- パラメータ:
sql-- 戻り値:
-
readMapFirst
Map<String,Object> readMapFirst(String sql, Object... parameters)
Reads a first row from the database by mapping the results of the SQL query into an instance ofMap.Letter case of the key in the Map depends on
ResultSetConverter.toSingleMap(org.nkjmlab.sorm4j.extension.SormOptions, java.sql.ResultSet, java.util.List<java.lang.String>, java.util.List<java.lang.Integer>)Types returned from the database will be converted to Java types in the map according with the correspondence defined in
ResultSetConverter.toSingleMap(SormOptions, ResultSet, List, List).Parameters will be set according with the correspondence defined in
SqlParametersSetter.setParameters(SormOptions, PreparedStatement, Object... )- パラメータ:
sql- with ordered parameter. The other type parameters (e.g. named parameter, list parameter) could not be used.parameters- are ordered parameter.
-
readMapLazy
LazyResultSet<Map<String,Object>> readMapLazy(ParameterizedSql sql)
- パラメータ:
sql-- 戻り値:
-
readMapLazy
LazyResultSet<Map<String,Object>> readMapLazy(String sql, Object... parameters)
Returns anLazyResultSetinstance containing data from the execution of the provided parametrized SQL and convert it to Stream, List, and so on.Types returned from the database will be converted to Java types in the map according with the correspondence defined in
ResultSetConverter.toSingleMap(SormOptions, ResultSet, List, List).Parameters will be set according with the correspondence defined in
SqlParametersSetter.setParameters(SormOptions, PreparedStatement, Object... )- パラメータ:
sql- with ordered parameter. The other type parameters (e.g. named parameter, list parameter) could not be used.parameters- are ordered parameter.
-
readMapList
List<Map<String,Object>> readMapList(ParameterizedSql sql)
- パラメータ:
sql-- 戻り値:
-
readMapList
List<Map<String,Object>> readMapList(String sql, Object... parameters)
Reads a list of objects from the database by mapping the SQL execution results to instances ofMapcontaining data from the execution of the provided parameterized SQL.Letter case of the key in the Map depends on
ResultSetConverter.toSingleMap(org.nkjmlab.sorm4j.extension.SormOptions, java.sql.ResultSet, java.util.List<java.lang.String>, java.util.List<java.lang.Integer>)Types of value returned from the database will be converted to Java types in the map according with the correspondence defined in
ResultSetConverter.toSingleMap(SormOptions, ResultSet, List, List).Parameters will be set according with the correspondence defined in
SqlParametersSetter.setParameters(SormOptions, PreparedStatement, Object... )- パラメータ:
sql- with ordered parameter. The other type parameters (e.g. named parameter, list parameter) could not be used.parameters- are ordered parameter.
-
readMapOne
Map<String,Object> readMapOne(ParameterizedSql sql)
- パラメータ:
sql-- 戻り値:
-
readMapOne
Map<String,Object> readMapOne(String sql, Object... parameters)
Reads a first row from the database by mapping the results of the SQL query into an instance ofMap. If the given SQL statement gets non-unique result,SormExceptionis thrown.Letter case of the key in the Map depends on
ResultSetConverter.toSingleMap(org.nkjmlab.sorm4j.extension.SormOptions, java.sql.ResultSet, java.util.List<java.lang.String>, java.util.List<java.lang.Integer>)Types of value returned from the database will be converted to Java types in the map according with the correspondence defined in
ResultSetConverter.toSingleMap(SormOptions, ResultSet, List, List).Parameters will be set according with the correspondence defined in
SqlParametersSetter.setParameters(SormOptions, PreparedStatement, Object... )- パラメータ:
sql- with ordered parameter. The other type parameters (e.g. named parameter, list parameter) could not be used.parameters- are ordered parameter.
-
readOne
<T> T readOne(Class<T> type, ParameterizedSql sql)
Reads only one object from the database.- 型パラメータ:
T- the type to map the result set rows to- パラメータ:
type- the type to map the result set rows tosql-- 戻り値:
-
readOne
<T> T readOne(Class<T> type, String sql, Object... parameters)
Reads only one object from the database.- 型パラメータ:
T- the type to map the result set rows to- パラメータ:
type- the type to map the result set rows tosql- with ordered parameter. The other type parameters (e.g. named parameter, list parameter) could not be used.parameters- are ordered parameter.- 戻り値:
-
readTupleList
<T1,T2,T3> List<Tuple3<T1,T2,T3>> readTupleList(Class<T1> t1, Class<T2> t2, Class<T3> t3, ParameterizedSql sql)
Reads results as List ofTuple3for reading JOIN SQL results typically.- 型パラメータ:
T1-T2-T3-- パラメータ:
t1-t2-t3-sql-- 戻り値:
-
readTupleList
<T1,T2,T3> List<Tuple3<T1,T2,T3>> readTupleList(Class<T1> t1, Class<T2> t2, Class<T3> t3, String sql, Object... parameters)
Reads results as List ofTuple3for reading JOIN SQL results typically.- 型パラメータ:
T1-T2-- パラメータ:
t1-t2-sql-parameters-- 戻り値:
-
readTupleList
<T1,T2> List<Tuple2<T1,T2>> readTupleList(Class<T1> t1, Class<T2> t2, ParameterizedSql sql)
Reads results as List ofTuple2for reading JOIN SQL results typically.- 型パラメータ:
T1-T2-- パラメータ:
t1-t2-sql-- 戻り値:
-
readTupleList
<T1,T2> List<Tuple2<T1,T2>> readTupleList(Class<T1> t1, Class<T2> t2, String sql, Object... parameters)
Reads results as List ofTuple2for reading JOIN SQL results typically.- 型パラメータ:
T1-T2-- パラメータ:
t1-t2-sql-parameters-- 戻り値:
-
update
<T> int[] update(List<T> objects)
Updates by objects on the table corresponding to the class of the given objects.- 型パラメータ:
T-- パラメータ:
objects-- 戻り値:
-
update
<T> int update(T object)
Updates by an object on the table corresponding to the class of the given object.- 型パラメータ:
T-- パラメータ:
object-- 戻り値:
-
update
<T> int[] update(T... objects)
Updates by objects on the table corresponding to the class of the given objects.- 型パラメータ:
T-- パラメータ:
objects-- 戻り値:
-
updateOn
<T> int[] updateOn(String tableName, List<T> objects)
Updates by objects on the table corresponding to the given table name.- 型パラメータ:
T-- パラメータ:
tableName-objects-- 戻り値:
-
updateOn
<T> int updateOn(String tableName, T object)
Updates by an object on the table corresponding to the given table name.- 型パラメータ:
T-- パラメータ:
tableName-object-- 戻り値:
-
updateOn
<T> int[] updateOn(String tableName, T... objects)
Updates by objects on the table corresponding to the given table name.- 型パラメータ:
T-- パラメータ:
tableName-objects-- 戻り値:
-
-