Искам например да създам клас с помощни методи
public class Util {
public static void f (int i) {...}
public static int g (int i, int j) {...}
}
Кой е най-добрият метод за създаване на полезен клас?
Трябва ли да използвам частен конструктор?
Трябва ли да направя полезния клас за абстрактен клас?
Нищо ли да не правя?
За напълно бездържавен помощен клас в Java предлагам класът да бъде деклариран public и final и да има частен конструктор, за да предотврати инстанцирането. Ключовата дума final предотвратява подкласиране и може да подобри ефективността по време на изпълнение.
Класът трябва да съдържа всички static методи и не трябва да се декларира abstract (тъй като това би означавало, че класът не е конкретен и трябва да бъде имплементиран по някакъв начин).
На класа трябва да се даде име, което съответства на неговия набор от предоставени помощни програми (или „Util“, ако класът трябва да предостави широк набор от некатегоризирани помощни програми).
Класът не трябва да съдържа вложен клас, освен ако вложеният клас трябва да бъде и полезен клас (въпреки че тази практика е потенциално сложна и вреди на четливостта).
Методите в класа трябва да имат подходящи имена.
Методите, използвани само от самия клас, трябва да бъдат частни.
Класът не трябва да има нефинални/нестатични класови полета.
Класът може също така да бъде импортиран статично от други класове, за да се подобри четимостта на кода (това обаче зависи от сложността на проекта).
Пример:
public final class ExampleUtilities {
// Example Utility method
public static int foo(int i, int j) {
int val;
//Do stuff
return val;
}
// Example Utility method overloaded
public static float foo(float i, float j) {
float val;
//Do stuff
return val;
}
// Example Utility method calling private method
public static long bar(int p) {
return hid(p) * hid(p);
}
// Example private method
private static long hid(int i) {
return i * 2 + 1;
}
}
Може би най-важното от всичко е, че документацията за всеки метод трябва да бъде точна и описателна. Вероятно методите от този клас ще се използват много често и е добре да имате висококачествена документация, която да допълва кода.
Според Joshua Bloch (Effective Java), трябва да използвате частен конструктор, който винаги хвърля изключение. Това най-накрая ще обезсърчи потребителя да създаде екземпляр на util клас.
Маркирането на абстрактен клас не се препоръчва, защото абстрактен подсказва на читателя, че класът е предназначен за наследяване.
AssertionError не е строго задължителен, но осигурява застраховка в случай, че конструкторът бъде случайно извикан от класа.
- person Leponzo; 05.04.2021
Бих направил класа final и всеки метод ще бъде static.
Така че класът не може да бъде разширен и методите могат да бъдат извикани от Classname.methodName. Ако добавите членове, уверете се, че работят безопасно ;)
Създаването на клас abstract изпраща съобщение до читателите на вашия код, че искате потребителите на вашия abstract клас да го подкласират. Това обаче не е това, което искате да направите тогава: полезен клас не трябва да бъде подклас.
Следователно добавянето на частен конструктор е по-добър избор тук. Трябва също така да направите класа final, за да забраните подкласирането на вашия полезен клас.
Should I do nothing?Как дзен. - person awwsmm schedule 07.12.2018