Аргумент против именования параметров: предпочтение или соглашение?

Question

Как бы банально это ни казалось, я не могу помочь своему любопытству. По вашему опыту, каковы некоторые соображения по удобочитаемости, когда дело доходит до именования аргументов и параметров? Аргументы находятся в вызовах функций и, таким образом, могут служить другим удобочитаемым целям, чем параметры в определениях функций. Когда имя аргумента должно быть более конкретным, чем его соответствующее имя параметра и наоборот, или они должны иметь одно и то же имя, когда это возможно?

Вам известны какие-либо условные обозначения или критерии, которые бы помогли решить так или иначе? Или вы бы сказали, что это относится к сфере предпочтений?

Заранее спасибо.

Answer 1

Параметр и аргумент как термины обычно используются взаимозаменяемо, но если мы хотим получить более конкретную информацию, то обычно это сводится к следующему:

Параметр - это просто имя в определении функции.

Аргумент - это объект, который будет передан этой функции.

Итак, допустим, у вас есть функция, которая принимает соединение с базой данных:

public void doDatabaseStuff (DatabaseConnection dbConnection) {...}

Здесь dbConnection - это параметр.

Когда вы действительно используете эту функцию, если вы используете базу данных Oracle, вы можете назвать это DatabaseConnection как oracleDbConnection и использовать его так:

DatabaseConnection oracleDbConnection = // some code to actually obtain that connection
doDatabaseStuff(oracleDbConnection);

Здесь у нас есть две вещи:

• dbConnection - имя параметра
• oracleDbConnection - имя аргумента

Из этого мы можем видеть, что имя параметра обычно является более «общим», чем имя аргумента, но это не обязательно должно быть так. Вы также можете просто использовать dbConnection в качестве имени аргумента, но oracleDbConnection является более значимым.

Answer 2

мммм .... При использовании стороннего / или фреймворческого метода вы можете захотеть сделать имя аргумента более кратким / отличным от этого, конечно, вы захотите, чтобы они соответствовали для согласованности ...