0Pricing
Lua Academy · Урок

Конструкторы и new()

Пишите функции-конструкторы, создающие и инициализирующие экземпляры.

«Конструкторы и new()» — бесплатный урок Lua Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Lua Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Lua Academy содержит 4 уроков всего.

Ответственность конструктора

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

local Player = {}
Player.__index = Player

function Player.new(name, hp, mp)
  assert(type(name)=="string" and name~="","need name")
  return setmetatable({
    name = name,
    hp   = hp or 100,
    mp   = mp or 50,
    alive = true,
    items = {},
  }, Player)
end

local p = Player.new("Hero")
print(p.name, p.hp, p.mp)  -- Hero  100  50

Цепочный конструктор

Цепочный конструктор возвращает self из методов установки, позволяя объединять вызовы методов при создании объекта. В Lua это шаблон строителя.

local Config = {}
Config.__index = Config

function Config.new()
  return setmetatable({_data={}}, Config)
end

function Config:set(k,v) self._data[k]=v; return self end
function Config:build() return self._data end

local cfg = Config.new()
  :set("host","localhost")
  :set("port",8080)
  :set("debug",true)
  :build()

print(cfg.host, cfg.port)

Конструктор копирования

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

local function deepCopy(orig)
  if type(orig)~="table" then return orig end
  local copy = {}
  for k,v in pairs(orig) do copy[deepCopy(k)]=deepCopy(v) end
  return setmetatable(copy, getmetatable(orig))
end

local Item = {}
Item.__index = Item

function Item.new(name, stats)
  return setmetatable({name=name, stats=stats or {}}, Item)
end

function Item:clone()
  return deepCopy(self)
end

local sword = Item.new("Sword",{damage=50})
local clone = sword:clone()
clone.stats.damage = 30
print(sword.stats.damage)  -- 50 (unchanged)

Конструктор с проверкой

Всегда проверяйте входные данные конструктора. Для недопустимых входных данных выбрасывайте понятные ошибки на уровне 2 (вина вызывающего кода). Это позволяет рано обнаруживать ошибки и формировать полезные сообщения об ошибках.

local Rectangle = {}
Rectangle.__index = Rectangle

function Rectangle.new(w, h)
  assert(type(w)=="number" and w>0,"width must be positive number")
  assert(type(h)=="number" and h>0,"height must be positive number")
  return setmetatable({width=w, height=h}, Rectangle)
end

function Rectangle:area() return self.width * self.height end
function Rectangle:perimeter() return 2*(self.width+self.height) end

local r = Rectangle.new(5, 3)
print(r:area(), r:perimeter())  -- 15  16

Шаблон значений по умолчанию

Используйте таблицу значений по умолчанию, чтобы корректно обрабатывать необязательные параметры конструктора. Это избавляет от длинных цепочек x = x or default и делает значения по умолчанию явными и простыми для изменения.

local Sprite = {}
Sprite.__index = Sprite

local DEFAULTS = {x=0,y=0,rotation=0,scale=1,visible=true,alpha=1}

function Sprite.new(image, opts)
  local cfg = opts or {}
  local self = {image=image}
  for k,v in pairs(DEFAULTS) do
    self[k] = cfg[k] ~= nil and cfg[k] or v
  end
  return setmetatable(self, Sprite)
end

local s = Sprite.new("hero.png",{x=100,y=200})
print(s.x,s.y,s.scale)  -- 100 200 1

Статические фабричные методы

У класса может быть несколько фабричных методов для разных сценариев создания. Это чище, чем перегружать один конструктор множеством необязательных параметров.

local Color = {}
Color.__index = Color

function Color.fromRGB(r,g,b)
  return setmetatable({r=r,g=g,b=b}, Color)
end

function Color.fromHex(hex)
  hex = hex:gsub("#","")
  return setmetatable({
    r=tonumber(hex:sub(1,2),16),
    g=tonumber(hex:sub(3,4),16),
    b=tonumber(hex:sub(5,6),16),
  }, Color)
end

function Color:toHex()
  return string.format("#%02X%02X%02X",self.r,self.g,self.b)
end

local red = Color.fromHex("#FF0000")
print(red:toHex())  -- #FF0000

Реестр конструкторов

Используйте реестр для отслеживания всех экземпляров. Это позволяет выполнять глобальные операции, например «уничтожить все», или перебирать все объекты определённого типа.

local Enemy = {}
Enemy.__index = Enemy
Enemy._all = {}

function Enemy.new(name, hp)
  local self = setmetatable({name=name, hp=hp}, Enemy)
  Enemy._all[#Enemy._all+1] = self
  return self
end

function Enemy.destroyAll()
  for _, e in ipairs(Enemy._all) do
    print("Destroying:", e.name)
  end
  Enemy._all = {}
end

Enemy.new("Goblin",30)
Enemy.new("Orc",80)
print("Count:", #Enemy._all)  -- 2
Enemy.destroyAll()

Отложенная инициализация

Некоторые поля требуют больших вычислительных затрат. Используйте __index с функцией, чтобы вычислять их и кэшировать при первом обращении.

local BigData = {}
BigData.__index = function(t, k)
  if k == "processed" then
    print("Computing processed...")
    local result = {}
    for i,v in ipairs(rawget(t,"raw")) do result[i]=v*2 end
    rawset(t,"processed",result)
    return result
  end
end

function BigData.new(raw)
  return setmetatable({raw=raw}, BigData)
end

local d = BigData.new({1,2,3,4,5})
print(d.processed[3])  -- Computing...  6
print(d.processed[3])  -- 6 (cached, no recompute)

Прототип из экземпляра

Клонируйте экземпляр, чтобы создать другой экземпляр с теми же базовыми значениями. Клон получает ту же метатаблицу (тот же класс) и копию данных экземпляра. Это удобно для объектов-шаблонов.

local Unit = {}
Unit.__index = Unit

function Unit.new(t)
  return setmetatable({name=t.name,hp=t.hp,atk=t.atk}, Unit)
end

function Unit:clone()
  return Unit.new({name=self.name,hp=self.hp,atk=self.atk})
end

function Unit:__tostring()
  return self.name.."(HP:"..self.hp..",ATK:"..self.atk..")"
end

local template = Unit.new({name="Soldier",hp=100,atk=10})
local u1 = template:clone(); u1.name="Alpha"
local u2 = template:clone(); u2.name="Beta"
print(tostring(u1),tostring(u2))

Безопасность конструктора при ошибках

Если создание завершается ошибкой на полпути (например, при выделении ресурса), не допускайте утечки частично созданных объектов. Используйте pcall, чтобы перехватывать ошибки создания и при необходимости освобождать ресурсы.

local FileHandle = {}
FileHandle.__index = FileHandle

function FileHandle.new(path, mode)
  local f, err = io.open(path, mode or "r")
  if not f then
    return nil, "cannot open " .. path .. ": " .. err
  end
  return setmetatable({_f=f, path=path}, FileHandle)
end

function FileHandle:read(fmt) return self._f:read(fmt) end
function FileHandle:close() self._f:close() end

local fh, err = FileHandle.new("data.txt")
if not fh then print("Error:", err)
else print(fh:read("l")); fh:close()
end

Быстрая проверка

Какова роль конструктора (new()) в ООП Lua?

Итоги: конструкторы

Кратко:

  • Конструктор проверяет данные, инициализирует объект и вызывает setmetatable
  • Используйте таблицу значений по умолчанию для удобной обработки необязательных параметров
  • Используйте несколько фабричных методов для разных сценариев создания
  • Используйте конструктор копирования для объектов-шаблонов
  • Используйте отложенную инициализацию через __index для ресурсоёмких полей
  • При сбое конструктора (например, при выделении ресурса) возвращайте nil+err

Часто задаваемые вопросы

Урок «Конструкторы и new()» бесплатный?

Да — полный текст урока «Конструкторы и new()» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Lua Academy, подпишись на CoddyKit PRO. Курс Lua Academy содержит 4 уроков всего.

Чему я научусь в уроке «Конструкторы и new()»?

Пишите функции-конструкторы, создающие и инициализирующие экземпляры. Ты практикуешь Lua Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Lua Academy?

Предыдущий опыт не требуется. Lua Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.

Сколько времени занимает урок «Конструкторы и new()»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Lua Academy?

Да. Каждый урок Lua Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Классы с помощью метатаблиц
  2. Конструкторы и new()
  3. Методы экземпляров и self
  4. Инкапсуляция с замыканиями
← Назад к Lua Academy